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FOREWORD 


Tliis  technical  note  supplements  the  Computer-Based  Instruction  Authoring  Tools  System 
(CATS)  user’s  manual  (NPRDC  Tech,  Note  90-27).  It  is  intended  for  instructional  developers  who 
update  CATS  coiurseware.  ^ 

CATS  is  a  government-owned  set  of  software  tools  for  constructing  and  presenting  interactive 
courseware  on  a  personal  computer.  It  was  developed  by  Systems  Engineering  Associates  (SEA), 
San  Diego,  through  a  series  of  contracts  with  the  Navy  Personnel  Research  and  Development 
Center  (NAVPERSRANDCEN).  CATS  has  continued  to  evolve  because  of  the  relative  ease  with 
which  a  government-owned  system  can  be  modified  and  enhanced  to  meet  the  needs  of  new 
government  projects. 

This  publication  is  one  of  three  technical  notes  that  supplement  the  user’s  manual.  This 
document  describes  the  lesson  maintenance  system.  A  second  report  addresses  the  presentation 
system  using  a  prototype  software  program  called  Lesson  Manager  (NPRDC  Tech.  Note  90-28). 
A  third  report  is  intended  for  students  who  are  taking  the  computer-based  version  of  the  Defense 
Systems  Management  College’s  Funds  Management  and  Tools  for  Program  Management  lessons. 
TTie  objective  of  this  effort  was  to  provide  instructions  for  the  use  of  the  disks  that  the  students  are 
given  to  run  each  lesson  (NPRDC  Tech.  Note  90-29). 

These  three  reports  wer^  prepared  by  SEA  and  NAVPERSRANDCEN  as  part  of  the  Guidelines 
for  Transportable  Educatiob  and  Training  (GTET)  project.  The  Joint  Services  Manpower  and 
Training  Systems  Development  Program  funded  the  project  through  Program  Element  0604722A. 
The  primary  objective  of  OTET  is  to  develop  guidelines  for  transportable  education  and  training 
that  can  be  used  by  those  w^o  wish  to  develop  and  implement  transportable  instructional  packages. 
These  supplemental  reports  support  that  objective. 

i 

Questions  regarding  ^his  work  can  be  directed  to  Dr.  Michael  R.  Flaningam,  Code  162, 
Organizational  Systems  Department,  Navy  Personnel  Research  and  Development  Center,  (619) 
553-0554  or  AUTOVON  ,553-0554.  Requests  for  system  software  should  be  ^dressed  to  Dr.  Kirk 
Johnson,  Code  14,  Nayy  Personnel  Research  and  Development  Center,  (619)  553-7702  or 
AUTOVON  553-7702.  , 


r  •  ■  ■  - 


STEVEN  L.  DOCKSTADER 
Director,  Organizational  Systems  Department 
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SUMMARY 


Background 

The  Computer-Based  Instruction  Authoring  Tools  System  (CATS)  was  developed  under 
contract  for  the  Navy  Personnel  Research  and  Development  Onter.  The  objective  of  this  effort 
was  to  create  and  test  low-cost  computer-based  instructional  systems.  CATS  proved  to  be  the 
means  to  that  end.  CATS  has  continued  to  evolve  because  of  the  relative  ease  with  which  a 
government-owned  system  can  be  modified  and  enhanced  to  meet  the  emeiging  needs  of  new 
government  work. 

System  Capabilities 

CATS  materials  can  be  delivered  on  2^nith  1(X)  series  microcomputers  and  IBM  PC/XT/AT- 
compatible  microcomputers  operating  under  MS-DOS  (Microsoft  disk  operation^  system). 
Materials  can  be  authored  on  these  same  machines  as  well  as  on  VAX  and  Sun  computers  operating 
under  UNIX.  Materials  can  be  authored  and  compiled  on  one  type  of  machine  and  delivered  on 
another  type.  There  are  separate  versions  of  the  delivery  software  for  machines  with  Z-1(X),  CGA, 
EGA,  Tecmar,  and  Visage  graphics  boards. 

The  system  provides  drivers  for  a  Microsoft  compatible  mouse,  a  MicroTouch  touch  screen, 
and  an  Hitachi  VIP9500  videodisc  player  (all  are  optional).  Additional  drivers  can  be  developed 
and  added  to  the  system  at  minimal  cost. 

The  courseware  is  controlled  by  a  series  of  storyboards.  The  storyboard  is  the  building  block 
of  the  CATS  system.  It  is  a  block  of  text  that  specifies  what  the  computer  should  display  itj  a 
particular  screen  image,  how  it  should  react  to  student  responses  to  that  screen  image,  and  anything 
else  it  should  do  while  the  image  is  displayed.  Storyboards  can  be  written  with  any  word 
processing  program  that  can  save  files  in  an  unformatted  ASCII  text  mode.  Still  graphics  can  be 
developed  with  any  graphics  program,  provided  the  graphic  can  be  captured  by  Dr.  Halo,  a  graphics 
software  program  for  IBM-compatible  computers.  Animation  can  be  provided  by  several 
commercial  animation  software  packages. 

CATS  software  doe.s  two  things.  First,  it  compiles  text  files,  reducing  them  to  a  more  compact 
form.  This  is  done  before  the  lesson  is  presented  to  the  student.  Second,  it  interprets  die  compiled 
files,  creating  the  commands  that  actually  control  the  computer  while  the  lesson  is  being  presented 
to  the  student. 

There  are  no  prompts  or  menus  to  aid  the  author  during  lesson  development.  In  fact,  CATS  is 
not  active  while  the  storyboards  are  being  written.  Repetitive  features  of  a  lesson,  ranging  from 
parts  of  a  storyboard  to  a  series  of  complete  storyboards,  can  be  readily  copied  from  one  pan  of  the 
lesson  to  another  or  from  special  templates  created  by  the  author. 


Mdentification  of  .specific  equipment  and  software  is  for  documentation  only  and  does  not  imply  endorsement. 
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Users 


The  system  caji  be  used  without  fee  by  any  activity  of  the  Federal  Government  or  by  any 
contractor  who  is  developing  instructional  materials  for  exclusive  use  by  the  Federal  Government. 

Documentation 

Three  technical  notes  have  been  written  to  supplement  the  CATS  user’s  manual  (NPRDC  Tech. 
Note  90-27).  This  report  focuses  on  maintenance  of  CATS  courseware.  A  second  report  concerns 
the  presentation  system  and  the  use  of  a  prototype  software  program  called  Lesson  Manager 
(NPRDC  Tech.  Note  90-28).  The  third  supplement  report  is  a  guide  for  students  who  are  taking 
the  computer-based  version  of  the  Defense  Systems  Management  College’s  Funds  Management 
and  Tools  for  Program  Management  lessons  (NPRDC  Tech.  Note  90-29).  The  objective  of  this 
effon  was  to  provide  instructions  for  the  use  of  the  disks  that  the  students  are  given  to  run  each 
lesson. 

Future  Efforts 

The  user’s  manual  will  continue  to  be  revised  as  changes  are  made  to  CATS.  Users  are  urged 
to  contact  either  the  Defense  Technical  Information  Center,  Building  #5,  Cameron  Station, 
Alexandria,  Virginia  22304-6145,  or  Code  14,  Navy  Personnel  Research  and  Development  Center, 
about  updated  versions. 
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INTRODUCTION 


WHAT  IS  THIS  MANUAL  ABOUT? 

This  document  describes  the  maintenance  of  computer-based  instruction  developed  by  the  Navy 
Personnel  Research  and  Development  Center  (NPRDC)  using  the  Computer-based  Instruction  Au¬ 
thoring  Tools  System  (CATS). 

Presentation  and  maintenance  of  CATS  courseware  are  controlled  by  two  different  systems. 

1.  The  lesson  presentation  system  allows  CATS  courseware  to  be  presented  to  students. 
CATS  lessons  can  be  installed  and  presented  by  using  a  lesson  management  software  program 
called  Lesson  Manager.  Procedures  for  using  Lesson  Manager  are  described  in  Qomputer-Based 
Instruction  Authoring  Tools J^stem  (CATS):  Lesson  Presentation  (NPRDC  Tech.  Note  90-28). 
CATS  lessons  can  also  be  installed  and  presented  without  using  this  special  software.  Procedures 
for  installing  and  presenting  CATS  lessons  without  Lesson  Manager  are  given  in  Qomputer-Based 
Instruction  Authoring  Tools  System  (CATS):  Student  Guide  (NPRDC  Tech.  Note  90-29). 

2.  The  lesson  maintenance  system  allows  CATS  instructional  developers  to  create  presen¬ 
tation  disks  and  to  update  CATS  courseware.  The  lesson  maintenance  system  is  a  central  reposi¬ 
tory  for  all  CATS  courseware.  This  document  describes  the  lesson  maintenance  system  and 
details  procedures  for  its  use. 

WHO  WILL  USE  THIS  MANUAL? 

This  publication  supplements  the  CATS  user’s  manual  (NPRDC  TN-90-27)  and  is  intended  to  be 
used  by  instructional  developers  who  arc  experienced  computer  users  and  CATS  authors.  These 
personnel  should  already  understand: 

•  How  to  use  common  MS-DOS  commands  (i.c.,  copy,  rm) 

•  The  difference  between  MS-DOS  files  and  directories 

•  How  to  create  and  name  MS-DOS  files 

•  How  to  use,  create,  and  change  MS-DOS  tree-structured  directories 

•  How  to  use,  create,  and  change  MS-DOS  batch  files 

•  How  to  use  floppy  disks 

•  How  to  use  a  full-screen  text  editor  or  word  processor 

•  How  to  create  CATS  storyboards 

•  How  to  use  CAT  SC,  CATSM,  andCATSVIEW 

•  What  a  CATS  profile  file  is 


To  help  the  reader  in  understanding  the  concepts  and  terminology  associated  with  CATS,  a  glos¬ 
sary  is  included  at  the  end  of  the  report. 
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LESSON  MAINTENANCE  SYSTEM  COMPONENTS 


The  lesson  maintenance  system  consists  of  the  following  components: 

1.  Hardware: 

Zenith  100  series  and  IBM  PC/XT/AT-compadble  microcomputers 
Low-density  floppy  disk  drive 

2.  System  Software: 

MS-DOS 

CATS  system  files 
Word  processor 
Graphics  editor 
Animation  editor 

3.  CATS  Courseware.  The  files  used  to  create  and  present  computer-based  instruction  (CBI) 
with  the  CATS: 

Storyboard  files 
Graphic  files 
Animation  files 
CATS  variable  files 
Batch  files 
Segment  files 
Profile  files 
DIR  files 

This  document  addresses  details  about  the  system’s  courscwaic  only.  The  CATS  user’s  manual  of¬ 
fers  detailed  information  about  the  system’s  hardware  and  software. 

CATS  COURSEWARE  FILE  ORGANIZATION 

During  the  early  stages  of  courseware  development,  the  courseware  developer  creates  an  instruc¬ 
tional  outline  for  the  courseware  material.  Figure  1  illustrates  a  partial  outline  dividing  sample  in¬ 
structional  material  into  three  lessons  on  the  subject  of  word  processing  to  be  presented  as  CBI 
using  the  CATS.  Each  lesson  is  divided  into  topics,  and  each  topic  into  drill,  practice,  and  test  com¬ 
ponents.  Each  drill  is  divided  into  questions. 
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1  .CBI  Training:  Word  Processing 

1.1  Lesson:  Gettir)g Started 

1 .1  .a  Topic:  Running  the  Program 

1.1  .a.1  Oriil 

1.1. a.l.l  Question  i 

1.1. a.1.2  Question  2 

1.1. a.1.10  Question  10 

1.1  .a.2  Practice 

1.1  .a.3  Test 

1 .1  .b  Topic:  Creating  a  File 

1.1. c  Topic:  Saving  a  File 

* 

1.2.  Lesson:  Creating  Documents 

1 .3.  Lesson:  Advanced  Techniques 


Figure  1.  CATS  courseware  is  organized  using  outlines. 

CBI  requires  a  very  detailed  outline  of  its  instructional  material, 

CATS  courseware  files  arc  stored  on  the  system’s  hard  disk.  Hundreds  of  courseware  files  may  be 
required  to  create  and  present  modcratc-to-largc  CATS  lessons.  These  files  are  organized  on  the 
hard  disk  using  an  MS-DOS  directory  tree  whose  structure  is  based  on  the  courseware’s  instruc¬ 
tional  outline. 

Figure  2  shows  a  diagram  of  the  MS-DOS  directory  tree  for  the  material  in  Figure  1.  Each  box  rep¬ 
resents  a  directory.  Each  box  contains  the  directory  name  and  the  item’s  name  found  in  the  outline 
(Figure  1). 
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The  first  row  in  Figure  2  contains  a  single  directory  that  corresponds  to  the  first  level  in  the  outline 
in  Figure  1 .  The  second  row  of  directories  ctxresponds  to  the  second  level  of  items  (lessons)  in  the 
outline.  The  third  row  of  directories  corresponds  to  the  third  level  of  items  (topics)  in  tlie  outline. 
The  lowest  level  of  items  in  the  outline  are  ^es.  The  names  attached  to  the  directory  called  DRI  l.L 
are  files  that  correspond  to  the  most  subcmlinate  items  of  lesson  1  in  the  outline  (i.e.,  the  drill  qucs- 
tiCNis).  (Owing  to  EOS  limitations  on  file  name  length,  the  names  of  directories  and  files  may  have 
to  be  abbreviated  fonns  of  the  outline  names.) 
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Figure  2.  MS-DOS  directory  trees  organize  CATS  courseware  files. 
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Figure  3  shows  another  outline  and  its  coiresponding  directory  tree.  This  figure  suggests  that  items 
in  an  outline  do  not  need  to  be  called  lessons,  topics,  etc.  They  can  be  called  anything,  as  long  as 
it’s  done  in  a  consistent,  systematic  way.  For  example,  items  in  the  second  level  are  called  courses, 
whereas  items  in  the  second  level  of  Figure  1  are  called  lessons. 
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CATS  COURSEWARE  FILE  DESCRIPTIONS 

The  previous  section  described  how  to  outline  and  organize  course  material  using  an  MS-  DOS  di¬ 
rectory  tree  on  the  computer’s  hard  disk.  In  this  section  the  underlying  files  used  to  create  and 
present  this  course  material  are  discussed. 

There  are  two  types  of  courseware  files: 

1.  Source  files  are  computer  files  used  to  create  and  maintain  CBI  using  CATS.  Storyboard 
files,  graphic  files,  animation  files,  CATS  variable  files,  and  batch  files  are  source  files. 

2.  Presentation  files  are  computer  files  used  to  present  CBI  using  CATS .  Segment  files,  pro¬ 
file  files,  DIR  files,  graphic  files,  and  animation  files  are  presentation  files. 

Note:  Graphic  files  and  animation  files  are  both  source  and  presentation  files. 

Storyboard  Files 

Purpose  of  Storyboard  Files 

Storyboard  files  are  source  files  that  contain  the  basic  building  blocks  of  the  lesson.  They  contain 
information  that  controls: 

1.  What  the  student  sees  on  the  screen  during  the  CBI.  One  storyboard  file  may  contain 
several  screens  of  information.  For  example,  a  storyboard  file  that  presents  a  question  might  con¬ 
tain  a  question  screen,  a  feedback  screen  for  correct  answers,  and  a  feedback  screen  for  incorrect 
answers. 

2.  How  the  CBI  will  react  to  student  responses.  For  example,  a  storyboard  may  branch  to  a 
feedback  screen  if  the  student  gives  an  incorrect  answer  to  a  question. 

3.  The  lesson  support  files  used  by  the  CBI.  For  example,  a  storyboard  may  display  the  con¬ 
tents  of  a  graphic  file  on  the  screen. 

4.  What  data  are  collected  by  the  CBI.  For  example,  a  storyboard  may  save  test  scores  in  a 
text  file  for  later  use  by  the  instructor. 
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How  Storyboard  Files  Are  Created 

Storyboard  files  are  text  files  that  are  created  using  a  word  processor  (also  called  a  text  editor).  The 
CATS  user’s  manual  contains  detailed  information  about  how  to  create  storyboard  files. 

Where  Storyboard  Files  Are  Located 

Storyboard  files  are  located  in  subdirectories  at  the  bottom  of  the  courseware’s  directory  tree. 

Figure  4  illustrates  a  portion  of  the  directory  tree  from  Figure  1,  showing  storyboard  files  for  ques¬ 
tion  1  through  question  10. 


Figure  4.  Storyboard  file  location  for  question  1  through  question  10. 

Graphic  Files 

Purpose  of  Graphic  Files 

Graphic  files  are  both  source  files  and  presentation  files.  Graphic  images  are  used  by  storyboard 
files  to  enhance  CBI.  Graphic  files  contain  graphic  images  that  can  be  displayed  on  a  computer 
screen. 
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Two  types  of  graphic  files  are  used  by  the  CATS:  Full-screen  files  and  cut  files.  Full-screen  files 
contain  graphic  images  that  are  displayed  on  a  full  computer  screen.  These  files  automatically  have 
a  suffix  of  .PIC.  Cut  files  contain  graphic  images  that  are  displayed  on  a  part  of  the  computer 
screen.  These  files  automatically  have  a  suffix  of  .  CUT . 

The  CATS  user’s  manual  contains  more  detailed  information  about  how  to  display  graphic  images 
in  CATS  courseware  (see  the  Displaying  Screen  Images  section). 

How  Graphic  Files  Are  Created 

Graphic  files  are  produced  using  a  graphics  software  program  (also  called  a  graphics  editor)  such 
as  “Dr.  Halo”  or  “PC-Paintbrush.” 

Where  Graphic  Files  Are  Located 

Graphic  files  reside  in  the  same  directories  as  the  storyboard  files  that  use  them.  For  example,  if 
storyboard  QUESl  displays  a  full-screen  graphic  called  QUESl  .PIC,  then  that  graphic  file 
should  reside  in  the  same  directory  as  QUESl. 

Figure  5  shows  the  locations  of  the  graphic  files  used  by  the  storyboards  for  question  1  through 
question  10  in  the  word  processing  lesson.  (In  this  figure  and  in  some  later  figures,  the  list  of  graph¬ 
ic  files  is  separated  from  the  list  of  storyboard  files.  This  separation  is  used  to  make  the  figure  easier 
to  understand.  There  is  really  no  separation  of  file  lists  in  a  directory  on  the  hard  disk.) 


Figure  5.  Graphic  file  location  for  question  1  through  question  10. 
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Animation  Files 


Purpose  of  Animation  Files 

Animation  files  arc  both  source  and  presentation  files  and  contain  animated  graphic  sequences.  The 
file  name  extensions  for  these  files  are  either  .  PRO  or  .  TXT . 

How  Animation  Files  Are  Created 

Animation  files  are  created  using  an  animation  software  program  (also  called  an  animation  editor) 
such  as  “Show  Partner”  or  “Grasp.” 

Where  Animation  Files  Are  Located 

Like  graphic  files,  animation  files  reside  in  the  same  directories  as  the  storyboard  files  that  use 
them.  Figure  6  shows  the  locations  of  the  animation  and  graphic  files  used  by  the  storyboards  for 
question  1  through  question  10  under  one  topic  in  the  word  processing  lesson. 


Figure  6.  Animation  file  location  for  question  10. 


CATS  Variable  File  (CVARS) 


Purpose  of  the  CATS  Variable  File 

By  convention,  the  CATS  variable  file  is  named  CVARS .  CVARS  is  a  source  file  and  is  an  ASCII 
text  file  that  defines  the  variables  that  are  used  by  the  lesson. 

Every  author  variable  used  by  the  coiu^eware  in  the  courseware  directory  tree  must  be  defined  in 
the  CVARS  file.  Whenever  a  variable  is  added  or  removed  from  any  storyboard  in  the  courseware 
directory  tree,  CVARS  must  be  updated  to  reflect  the  change,  and  all  the  courseware  in  the  directory 
tree  must  be  recompiled.  'Ihere  must  be  only  one  CATS  variable  file  (CVARS)  for  the  courseware 
directory  tree.  For  more  information  about  the  CATS  variable  file,  see  the  CATS  user’s  manual 
(Variables  File  section). 

How  the  CATS  Variable  File  is  Created 

CVARS  is  a  text  file  created  with  a  word  processor  or  a  text  editor. 

Where  the  CATS  Variable  File  is  Located 

CVARS  is  always  located  in  the  topmost  directory  of  the  courseware  directory  tree.  In  Figure  7,  the 
CVARS  file  is  located  in  the  WORDP  directory  at  the  top  of  the  courseware  directory  tree. 

Batch  Files 

Purpose  of  Batch  Files 

Batch  files  ease  the  process  of  building  segment  files  (i.e.,  comprised  versions  of  storyboard  files) 
and  presentation  disks.  They  automatically  execute  the  DOS  commands  that  build  a  segment  file 
or  a  set  of  presentation  disks.  Batch  files  are  source  files. 

Batch  file  names  have  a  suffix  of  .  BAT . 

The  three  types  of  batch  files  used  in  the  lesson  maintenance  system  are: 

BUILD. BAT  Compiles  every  storyboard  in  the  directory  and  all  its  subdirectories  and 
produces  a  package  of  all  segment  files  in  the  directory  and  all  its  subdi¬ 
rectories. 
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Figure  7.  CATS  variable  file  (CVARS)  location  in  a  sample  courseware  directory  tree. 


QBUILD .  BAT  Uses  already-compiled  segment  files  to  produce  a  package  of  all  the 
segment  files  in  a  directory  and  all  its  subdirectories.  This  batch  file 
will  not  compile  any  storyboards  in  the  directory  or  its  subdirectories. 

D I S TRI B .  BAT  Creates  a  set  of  presentation  disks  for  the  courseware  in  a  directory. 

Appendix  A  contains  detailed  information  about  how  the  BUILD.BAT  andQBUILD.BAT  batch 
files  work.  Appendix  B  contains  detailed  information  about  how  the  DISTRIB.BAT  batch  file 
works. 


How  Batch  Files  Are  Created 

Batch  files  are  text  files  created  with  a  word  processor  or  text  editor. 

Where  Batch  Files  Are  Located 

BUILD.  BAT  and  QBU I LD .  BAT  reside  in  every  directory  of  the  courseware  directory  tree. 

Figure  8  shows  a  portion  of  the  courseware  directory  tree  for  the  word  processing  example. 
BUILD .  BAT  and  QBUILD .  BAT  batch  files  are  located  in  every  directory. 


Figure  8.  BUILD .  BAT  and  QBUILD .  BAT  file  locations  in  a  sample  directory  tree. 


The  author  makes  courseware  distributable  by  placing  a  D I STRIB .  BAT  file  in  each  directory  that 
contains  the  courseware  to  be  distributed. 

In  Figui’e  9,  aDISTRIB.  BAT  file  is  located  in  the  top  directory  and  in  the  directories  containing 
courseware  for  lesson  1  through  lesson  3.  As  a  result,  the  word  processing  lessons  could  be  distrib¬ 
uted  together  by  building  presentation  disks  in  the  top  directory,  or  each  lesson  could  be  distrib¬ 
uted  separately  by  building  presentation  disks  in  each  lesson  directory. 
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Figure  9.  DISTRIB .  BAT  file  locations  in  a  sample  directory  tree. 
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Segment  Files 

Purpose  of  Segment  Files 

Segment  files  are  presentation  files  that  compress  storyboard  files  into  a  single  larger  file.  Two 
CATS  software  programs  are  used  to  create  presentation  files:  CAT  SC,  which  compiles  storyboard 
files  into  segment  files  that  are  in  computer  language,  and  CATS  VIEW,  which  interprets  the  infor¬ 
mation  stored  in  segment  files  for  viewing.  Segment  files  are  automatically  named  with  a  .  SEG 
suffix. 


How  Segment  Files  Are  Created 

Segment  files  are  created  by  the  CATS  compiler  (CATSC).  Courseware  developers  or  maintenance 
operators  run  each  storyboard  file  through  CATSC  to  check  for  errors  and  to  produce  a  segment 
file  for  presentation. 

Figure  10  illustrates  how  a  single  segment  file  is  produced  from  a  single  storyboard  file.  The  shad¬ 
ed  box  represents  the  CATS  compiler  (CATSC).  The  arrow  pointing  to  the  box  represents  the  sto¬ 
ryboard  file  that  is  input  to  the  compiler.  The  arrow  pointing  away  from  the  box  represents  the 
segment  file  that  is  created  by  the  compiler.  At  the  top  of  the  figure  is  the  command  that  would  be 
used  to  create  the  segment  file.  In  this  example,  a  storyboard  called  QUESl  is  used  to  produce  a 
question  segment  called  QUESl .  SEG.  In  this  example,  a  segment  name  is  not  specified  in  the 
command.  As  a  result,  the  storyboard  file  named  QUES 1  is  used  to  create  the  segment  file  named 
QUESl . SEG. 


Figure  1 1  shows  how  multiple  segment  files  can  be  compiled  to  produce  a  single  larger  segment 
file.  The  larger  segment  contains  all  of  the  compressed  information  from  the  smaller  segments. 
This  is  a  convenient  way  of  packaging  many  small  lesson  segments  into  a  single  larger  segment 
file.  In  this  example,  all  the  information  in  segments  QUESl .  SEG  through  QUESl  0  .  SEG  is  pack¬ 
aged  into  one  segment  file.  In  this  case,  the  name  DRILL  was  specified  in  the  command.  Therefore, 
the  CATS  compiler  names  the  resulting  package  segment  DRILL .  SEG. 

The  CATS  user’s  manual  includes  more  details  about  how  to  use  CATSC  to  create  segment  files 
(see  Compiling  and  Viewing  a  Lesson  section). 

Where  Segment  Files  Are  Located 


There  should  be  one  segment  file  for  each  stcrj-bcard  file  in  a  dircctciy.  There  should  be  an  addi¬ 
tional  segment  file  that  is  a  package  containing  all  storyboard  segments  in  each  directory  and  all 
segments  from  the  directory’s  subdirectories. 
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Figure  10.  Producing  segment  files  with  the  CATS  compiler  (CATSC). 

If  you  type  this  DOS  Command: 


CATSC  DRILL  QUES1.SEG  QUES2.SEG  ...  QUES10.SEG 

This  process  will  begin: 


Figure  11.  Producing  package  segment  files  with  CATSC. 
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The  DRILL  directory  in  Figure  12  contains  one  segment  file  for  each  storyboard  file.  It  also  con¬ 
tains  the  additional  segment  file  drill  .  SEG  that  is  a  package  of  all  the  storyboard  segments  in 
the  directory. 

The  TOPICIA  directory  contains  the  segment  TOPICIA.  SEG.  This  is  a  package  that  contains 
DRILL .  SEG  from  the  DRILL  subdirectory,  PRACT .  SEG  from  the  PRACT  subdirectory,  and 
TEST.  SEG  from  the  TEST  subdirectory. 
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Figure  12.  How  segment  files  can  be  used  to  package  many  small  lesson  seg* 
meats  into  a  single  larger  segment. 

Profile  Files 

Purpose  of  Profile  Files 

Profile  files  are  presentation  files.  The  purpose  of  a  profile  file  is  to  tell  the  CATSVIEW  program 
which  segment  file  to  use  when  presenting  CBI.  To  find  the  correct  segment  file,  CATSVIEW  will 
always  look  for  a  file  called  PROFILE. CAT  and  then  read  its  contents.  The  contents 
of  PROFILE.  CAT  identify  which  segment  file  CAT  S  V I EW  uses  to  present  CBI.  Profile  files  are 
always  named  PROFILE .  CAT  by  CATSC. 
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How  Profile  Files  Are  Created 

CATSC  (the  CATS  compiler)  creates  a  PROFILE .  CAT  file  whenever  it  builds  a  segment  file. 
The  profile  file  contains  the  name  of  the  most  recent  segment  file  that  CATSC  built  in  the  directo- 
17.  If  CATSC  is  used  twice  in  the  same  directory  to  produce  two  separate  segment  files,  the  profile 
file  that  identifies  the  segment  that  was  built  first  will  be  overwritten  by  the  profile  file  that  iden¬ 
tifies  the  segment  file  that  was  built  second. 

Where  Profile  Files  Are  Located 

A  PROFILE .  CAT  file  resides  in  the  same  directory  as  the  segment  files  it  identifies. 

If  a  profile  file  is  in  a  directory  that  contains  more  than  one  segment,  the  profile  file  will  identify 
the  most  recendy  created  segment.  There  is  only  one  PROFILE .  CAT  file  in  each  directory. 

Figure  13  shows  the  locations  of  the  profile  files  that  identify  the  most  recently  built  segment  files 
in  the  TOP  ICIA  directory  and  the  drill  directory. 

DIR  Files 

Purpose  of  DIR  Files 

DIR  files  are  presentation  files  that  are  used  by  CATSVIEW  to  locate  information  in  a  segment  file. 
DIR  file  names  always  end  with  a  .DIR  extension . 

How  DBR  Files  Are  Created 

DIR  files  are  automatically  created  the  first  time  CATSVIEW  is  executed.  If  the  DIR  file  is  present, 
CATSVIEW  will  start  faster.  If  the  DIR  file  has  been  removed  or  is  out  of  date,  it  will  be  built  again 
the  next  time  CATSVIEW  is  executed. 

Where  DIR  Files  Are  Located 

DIR  files  are  created  in  the  directories  where  a  segment  file  is  presented  with  CATSVIEW.  In 
Figure  14,  the  TOPICIA  directory  containsaDIRfilecalled  TOPICIA. DIR.  This  DIR  file  was 
created  when  CATSVIEW  presented  TOPICIA. SEG.  There  is  dso  a  DIR  file  called 
DRILL. DIR  in  the  DRILL  directory.  This  DIR  file  was  created  when  DRILL . SEG  was 
presented  with  CATSVIEW . 
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Figure  13.  How  profile  files  reside  in  the  same  directory  as  the  segment  files  they  identify. 


Figure  14.  DIR  files  are  created  in  the  directories  where  a  segment  file  is  presented. 
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LESSON  MAINTENANCE  SYSTEM  PROCEDURES 


This  section  describes  the  lesson  maintenance  system  procedures  that  allow  CATS  courseware  in¬ 
structional  developers  to  install  the  courseware  onto  dte  lesson  maintenance  system,  to  create  pre¬ 
sentation  disks,  and  to  change  CATS  courseware. 

As  the  courseware  developer,  you  probably  received  the  CATS  courseware  on  floppy  disks  and  are 
now  responsible  for: 

•  Installing  the  courseware  onto  the  lesson  maintenance  system. 

•  Distributing  the  courseware  to  students. 

•  Changing  the  courseware  to  meet  new  requirements  requested  by  instructors  or  students. 

This  document  is  intended  to  help  you  accomplish  this  with  as  little  trouble  as  possible.  First,  we’ll 
discuss  the  materials  with  which  you’ll  be  working,  then  we’ll  discuss  the  steps  of  installing,  dis¬ 
tributing,  and  changing  the  courseware. 

THE  MATERIAL  YOU  HAVE 

You  most  likely  received  the  courseware  in  several  sets  of  floppy  disks: 

1.  Presentation  disks  used  to  present  courseware  to  students.  (These  disks  are  probably  la¬ 
beled  “Disk  1,”  “Disk  2,’’  etc.) 

2.  Source  disks  that  contain  the  source  files  used  to  develop  the  courseware.  (These  disks  are 
probably  labeled  “Source  Files’’  or  “Storyboard  Files’’  and  name  the  courseware  involved.) 

You  probably  also  received  a  hardcopy  courseware  directory  for  each  lesson  illustrating  the 
courseware  tUrectory  tree  that  is  used  to  organize  the  courseware  files.  The  courseware  directory 
will  help  you  visualize  the  organization  of  the  courseware  files  on  the  source  and  presentation  disks 
and  in  your  lesson  maintenance  system. 

After  receiving  the  source  disks,  you  will  most  likely  w'ant  to  install  the  source  files  onto  your  les¬ 
son  maintenance  system’s  hard  disk.  The  next  section.  Installing  the  Courseware  Files,  covers  the 
procedures  for  doing  this. 

Next,  you  may  want  to  distribute  courseware.  This  means  that  you  will  have  to  make  copies  of  your 
presentation  dhsks.  The  procedures  for  copying  and  updating  these  disks  are  discussed  in  the  sec¬ 
tion  ahead  called  Making  Presentation  Disks. 

Eventually  you  may  need  to  make  a  variety  of  changes  to  the  courseware.  Courseware  content  may 
change,  an  instructor  may  want  to  shift  emphasis  from  one  point  to  another,  or  you  may  want  to 
add  or  delete  information.  Changing  courseware  is  probably  the  most  complicated  task  you  will 
have  to  do.  The  procedures  for  changing  courseware  are  in  the  Changing  Courseware  section. 
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INSTALLING  THE  COURSEWARE  FILES 


The  courseware  directory  illustrates  the  courseware  directory  tree  used  to  organize  the  source  files 
in  the  lesson  maintenance  system. 

For  each  directory  in  the  courseware  directoiy  tree,  there  should  be  one  or  more  source  disks  that 
contain  all  the  files  belonging  in  that  directory. 

To  install  the  source  files  from  the  source  disks  to  your  hard  disk,  do  the  following: 

1 .  Build  the  courseware  directory  tree  that  is  used  to  organize  the  source  files.  Do  this  by  using 
the  DOS  mkdir  command.  You  can  use  the  courseware  directory  as  a  “blueprint”  of  this  direc¬ 
tory  tree. 

2.  After  the  courseware  directory  tree  is  built,  place  all  the  source  files  in  their  proper  direc¬ 
tories.  Each  source  file  disk  should  be  labeled  with  a  directory  name.  All  the  files  on  a  source  file 
disk  belong  in  the  directory  that  is  on  the  disk’s  label.  Figure  15  illusoates  how  the  label  on  the 
source  file  disk  indicates  the  directory  where  all  the  files  on  the  disk  belong. 

Therefore,  copy  all  files  of  each  source  file  disk  into  the  directory  indicated  by  the  disk’s 

label. 

MAKING  PRESENTATION  DISKS 

Presentation  disks  contain  all  the  courseware  files  needed  to  present  the  CBI.  The  following  sec¬ 
tions  discuss: 

1 .  How  to  make  copies  of  presentation  disks  you  already  have. 

2.  How  to  update  presentation  disks  to  reflect  changes  made  to  the  courseware. 

3.  What  to  do  to  distribute  a  portion  of  the  courseware  that  was  not  initially  made  distribut¬ 
able. 

Making  Copies  of  Presentation  Disks 

If  the  courseware  has  not  changed,  and  if  you  want  to  copy  some  presentation  disks,  use  the  DOS 
DISKCOPY  command  to  make  the  copies.  (Check  your  DOS  manual  for  specific  instructiens  on 
how  to  use  the  DISKCOPY  command.) 
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Figure  15.  Example  of  how  the  label  on  a  source  disk  can  indicate  the  direc¬ 
tory  where  all  Tiles  on  the  disk  belong. 

Updating  Presentation  Disks 

To  distribute  courseware  that  has  been  changed,  you  must  update  its  set  of  presentation  disks.  (For 
procedures  on  how  to  change  courseware,  see  the  Changing  Courseware  section.) 

Each  set  of  presentation  disks  you  received  corresponds  to  a  particular  directory  in  the  courseware 
directory  tree.  Each  of  these  directories  should  contain  the  DISTRIB .  BAT  batch  file  that  is  u.sed 
to  build  presentation  disks. 

For  example,  Figure  16  illustrates  a  portion  of  the  directory  tree  for  the  word  prrxjessing  example. 
You  would  have  received  a  set  of  presentation  disks  for  the  courseware  in  the  directories  \WORDP 
and  LE  S  S  ON  1  tlu-ough  LE  S  S  ON  3 ,  since  these  are  the  directories  that  contain  the  batch  files  D I S  ~ 
TRIB.BAT. 

Updating  presentation  disks  consists  of  using  DISTRIB.BAT  to  rebuild  the  presentation  disks. 
The  procedure  for  updating  presentation  disks  is  given  in  Table  1. 

Note:  Before  using  DISTRIB .  BAT  to  update  the  presentation  disks,  make  sure  all  of  the  segment 
files  are  current. 
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Figure  16.  Courseware  in  directories  that  contain  theDlSTRlB.  BATfilecan 
be  distributed. 

D I STRIB .  BAT  does  not  build  any  segment  files.  It  builds  only  presentation  disks.  This  means  that 
if  you  did  not  rebuild  a  segment  file  after  changing  a  storyboard  file  and  used  DISTRIB .  BAT  to 
build  presentation  disks,  then  the  courseware  on  the  presentation  disks  would  not  reflect  any  of  the 
changes  you  made  to  the  storyboard  files.  (See  Appendix  B  for  details  of  how  DISTRIB.BAT 
works.) 
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Table  1 


Updating  Presentation  Disks 


_ _ Procedure  For  Updating  Presentation  Disks _ 

1.  Move  to  the  appropriate  *  Move  to  the  directory  in  the  courseware  directory 

directory.  treewhosepresentationdisksneedtobeupdated. 

2.  TypeDISTRIB.BAT  •  Follow  the  instructions  on  the  screen.  Notice  that 

DISTRIB.BAT  should: 

•  Format  the  presentation  disks  (including  a 
generic  student  disk). 

•  Copy  the  segment  files,  the  graphic  and 
animation  files,  and  the  CATS  presentation 

_ software  files  to  the  presentation  disks. _ 


Making  Courseware  Distributable 

Any  courseware  in  the  courseware  directory  tree  can  become  distributable.  The  presentation  disks 
you  initially  received  correspond  to  the  portions  of  the  courseware  the  original  developer  decided 
to  make  distributable.  This  section  discusses  how  you  can  make  other  portions  of  the  courseware 
distributable. 

To  make  a  portion  of  the  courseware  distributable,  follow  the  steps  in  Table  2. 

CHANGING  COURSEWARE 

You  will  probably  want  to  make  changes  to  the  courseware  from  time  to  time.  Lesson  content  may 
change  or  an  instructor  may  want  to  shift  emphasis  from  one  point  to  another.  (This  document  cov¬ 
ers  only  those  actions  that  occur  before  and  after  a  storyboard  file  is  changed.  It  does  not  focus  on 
the  process  of  changing  a  storyboard  file.  The  CATS  user’s  manual  offers  detailed  information 
about  how  to  CTeate  and  update  a  storyboard  file.) 

A  Helpful  Hint:  Back  Up  Your  Courseware  Directory  Tree 

Before  beginning  to  change  the  courseware,  it  is  a  good  idea  to  make  a  backup  copy  of  the  existing 
courseware  directory  tree  and  all  the  source  files  within  it.  There  are  two  reasons  for  this  action. 
First,  if  you  make  a  mistake  when  changing  courseware,  you  will  be  able  to  use  your  backup  copy 
to  start  from  scratch.  Second,  if  your  hard  disk  is  erased  (or  something  else  equally  damaging  hap¬ 
pens),  you  will  be  able  to  rebuild  the  entire  courseware  directory  tree  from  the  backup  copy. 

It  is  also  a  good  idea  to  make  a  backup  copy  of  the  courseware  directory  tree  when  releasing  any 
new  versions  of  the  courseware.  Then,  if  you  are  asked  to  alter  a  previous  release  of  the  course¬ 
ware,  you  can  rebuild  the  appropriate  version  of  the  courseware  directory  tree. 
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You  must  determine  the  best  way  to  make  backup  copies.  The  method  you  choose  will  depend  on 
which  software  packages  you  already  have  and  on  the  types  of  tools  with  which  you  are  most  com¬ 
fortable.  If  you  have  no  special  backup  tool,  you  can  always  use  the  DOS  BACKUP  and  RESTORE 
facilities. 


Table  2 

Making  a  Portion  of  the  Courseware  Distributable 


Procedures  For  Making  A  Portion  Of  The  Courseware  Distributable 


1.  Create  the 

DISTRI.BAT  batch 
file  for  the  part  of 
the  courseware  you 
want  distributed. 


2.  Edit  the  new  batch 
file. 


3.  Test  the  new  batch 
file. 


•  BesureyouunderstandhowtheDISTRIB.BAT  file woiks. (See 
Appendix  B  for  detailed  information  detailed  information 
aboutDISTRIB.BAT.) 

•  Move  to  the  directory  that  corresponds  to  the  part  of  the 
courseware  you  want  to  make  distributable. 

If  any  of  the  flies  in  the  directory  are  larger  than  360  kilobytes, 
follow  the  instructions  in  Appendix  C,  Handling  Presentation 
Di.<:k  Size  Constraints. 

•  Create  a  D I S  TRI B .  BAT  for  the  new  directory.  The  easiest 
way  to  create  a  new  DISTRIB .  BAT  file  is  to  alter  a  copy  of  an 
existing  DISTRIB.BAT  file.  Do  this  by  finding  an  existing 
DISTRIB.BAT  file  and  copying  it  into  the  directoiy.  Use  one 
that  belongs  to  a  similar  directory. 

»  Edit  the  new  D I STRIB .  BAT  file  with  your  word  processor  and 
revise  the  DOS  commands  so  they  will: 

•  Copy  all  the  graphic  and  animation  files  from  the  directory  and 
all  its  subdirectories  into  the  temporary  directory  called 
INSTALL.  (Be  sure  to  use*.  PIC,  *.CUT,  and  *.PR0 
or  * .  TXT  when  copying  the  graphic  and  animation  files  to 
the  INSTALL  directory.  That  way,  you  will  not  have  to 
update  the  DISTRIB . BAT  each  time  you  add  or  remove  a 
graphic  or  animation  file.) 

•  Copy  the  directory’s  package  segment  into  the  install 
directory. 

•  Save  the  DISTRIB .  BAT  file  as  an  non-document  or  ASCII 
file. 

•  Execute  the  new  DISTRIB.  BAT  file  to  verify  that  it  copied  the 
directory’s  package  segment  as  well  as  all  the  graphic  and 
animation  files  for  the  directory  and  its  subdirectories  to  the 
INSTALL  directory. 

•  Watch  for  compilation  errors. 

•  Use  the  presentation  disks  to  install  the  courseware  on  a 
different  computer  and  verify  that  the  courseware  works. 


Making  Changes  to  Courseware 

When  making  changes,  it  is  important  to  know  which  changes  will  require  you  to  also  update  tlfc 
BUILD  andQBUILD  batch  files  in  the  courseware  directory  tree.  Table  3  should  help. 
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Tables 


Types  of  Courseware  Changes  that  DO  or  DO  NOT  Affect  the 
BUILD  and  QBUILD  Batch  Files 


Type  Of  Courseware  Change 

NO 

YES 

Alter  a  storyboard  in  a  storyboard  file 

X 

Add  storyboard  to  a  storyboard  file 

X 

Remove  a  storyboard  from  a  storyboard  file 

X 

Alter  a  graphic  or  animation  file 

X 

Add  a  new  graphic  or  animation  file 

X 

Remove  a  graphic  or  animation  file 

X 

Add  a  new  storyboard  file 

X 

Remove  a  storyboard  file 

X 

Add  a  new  directory 

X 

Remove  a  directory 

X 

Notice  that  changes  made  to  an  existing  file  require  no  changes  to  the  BU I  TjD  and  QBU I LD  batch 
files.  Also,  adding  or  removing  a  graphic  or  animation  file  requires  no  changes  to  the  batch  files. 
However,  if  you  add  or  remove  a  storyboard  file,  the  BUILD  and  QBUILD  batch  files  must  be  up¬ 
dated  to  reflect  the  change. 

BUILD  and  QBUILD  batch  files  contain  DOS  commands  that  refer  to  storyboard  files.  If  a  story¬ 
board  file  has  been  added,  the  storyboard  file’s  name  must  be  added  to  the  appropriate  batch  files. 
If  a  storyboard  file  has  been  removed,  the  storyboard  file’s  name  must  be  removed  from  the  appro¬ 
priate  batch  files. 

If  any  of  the  files  that  you  create  or  alter  become  larger  than  360  kilobytes,  follow  the  instrucdons 
given  in  Appendix  C,  Handling  Presentation  Disk  Size  Constraints. 

If  the  changes  involve  adding  or  deleting  author  variables,  you  must  update  the  CATS  variable  file 
(CVARS)  and  recompile  all  the  courseware  in  the  courseware  directory  tree. 

Changes  That  DO  NOT  Affect  BUILD  and  QBUILD  Batch  Files 

The  procedures  for  making  changes  that  do  not  affect  BUILD  and  QBUILD  batch  files  are  three¬ 
fold.  They  consist  of  (1)  making  the  change,  (2)  recompiling  the  segment,  and  then  (3)  testing  the 
results.  TTie  procedure  for  altering  a  storyboard  in  a  storyboard  file  is  given  in  Table  4. 
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Table  4 


Altering  a  Storyboard  in  a  Storyboard  File 


Procedure  For  Altering  a  Storyboard  in  a  Storyboard  File 


1 .  Change  the  storyboard  file. 


Move  to  the  directory  that  contains  the  storyboard  file. 
Retrieve  the  storyboard  file  as  a  non-document  or  ASCII  file. 
Use  your  word  processor  to  edit  the  storyboard  file. 

Save  the  changed  storyboard  file  as  a  non-document  or 
ASCnfUe. 


2.  Recompile  the  segment  for 
the  storyboard  file. 


Use  CATSC  to  rebuild  the  segment  file  for  the  storyboard 
file. 

Watch  for  any  compilation  errors.  If  there  are  such  errors, 
reedit  the  storyboard  file  to  fix  them  and  then  go  back  to  the 
begitming  of  step  2  to  rebuild  the  segment  file. 

Check  the  size  of  the  segment  file  and  any  graphic  or 
animation  files  that  it  requires.  Graphic  or  animation  files 
larger  than  360  kilobytes  are  currently  not  distributable.  If 
there  are  any  files  larger  than  360  kilobytes,  you  may  have 
to  alter  the  DI STRIB .  BAT  file  for  the  directory.  Follow 
the  instructions  in  Appendix  C,  Handling  Presentation  Disk 
Size  Constraints. 


3.  Test  the  segment  for  the 
storyboard  file. 


Use  CATSVIEW  to  view  the  new  segment  file  and  verify 
that  the  storyboard  reflects  your  alterations. 

Verify  that  the  segment  file’s  screens,  branching,  data 
collection,  etc.,  are  correct. 


When  altering  or  adding  a  graphic  or  animation  file,  use  a  graphic  or  animation  editor  instead  of  a 
word  processor.  There  is  no  need  to  rebuild  segments  if  you  have  only  changed  an  existing  graphic 
or  animation  file.  However,  you  should  still  use  CATSVIEW  to  verify  that  the  altered  graphic  or 
animation  file  is  correct. 

When  you  finish  changing  the  stoiyboaid  files  in  a  directory,  use  QBU1LD.BAT  or  BUILD.BAT 
to  rebuild  the  directory’s  package  segment,  and  then  use  CATSVIEW  to  test  it.  You  want  to  make 
sure  that  the  changes  made  to  each  storyboard  file  will  not  conflict  with  other  s  oryboard  files  in 
the  directory. 

Note:  To  use  QBUILD .  BAT,  all  storyboards  must  be  already  compiled  with  the  most  current  seg¬ 
ment  files.  If  all  storyboards  are  not  compiled,  use  BUILD.BAT  to  create  the  updated  segment 
files. 

After  you  finish  making  changes  between  package  segments  (i.e.,  between  subdirectories),  rebuild 
the  next  highest  package  segment  in  the  courseware  dkectory  tree.  You  want  to  be  sure  your  chang¬ 
es  have  not  caused  conflicts  between  package  segments. 
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Changes  That  DO  Affect  BUILD  and  QBUILO  Batch  Files 

Changes  that  cause  a  stoiyboard  file  to  be  added,  removed,  or  renamed  will  affect  the  BU I LD  and 
QBUILD  batch  files.  These  batch  files  contain  commands  that  manipulate  files  in  the  directory  tree. 
If  a  storyboard  file  has  been  added,  the  storyboard  file  name  must  be  added  to  the  appropriate  batch 
files.  If  a  stoiyboard  file  has  been  removed,  the  storyboard  file  name  must  be  removed  from  the 
appropriate  batch  files.  If  a  stoiyboard  file  has  been  renamed,  the  original  name  must  be  removed 
and  the  new  name  must  be  added  to  the  appropriate  batch  files. 

Adding  or  Removing  a  Storyboard  File 

The  steps  for  adding  a  storyboard  file  are  given  in  Table  5,  and  an  example  is  illustrated  in  Figure 
17.  The  steps  for  removing  a  storyboaid  file  are  given  in  Table  6. 

Adding  a  Directory  to  the  Courseware  Directory  Tree 

Recall  that  each  directory  or  stoiyboard  file  in  the  courseware  directory  tree  coiresponds  to  an  item 
in  the  instructional  outline  of  the  courseware  material.  If  you  choose  to  add  an  item  to  the  outline, 
you  will  have  to  add  a  directory  and/or  a  storyboard  file  to  the  courseware  directory  tree. 

If  the  new  item  belongs  at  the  lowest  level  of  the  instructional  outline  (i.e.,  if  it  is  not  divided  into 
other  items),  then  you  have  only  to  add  a  storyboard  file  to  the  appropriate  directory  in  the  directory 
tree.  Adding  a  question  to  the  drill  in  the  word  processing  example  illustrates  this  type  of  change. 
If  the  new  item  is  divided  into  other  items,  you  must  add  a  directory  and  the  appropriate  number 
of  storyboard  files  to  the  courseware  directory  tree.  Adding  an  item  called  “review”  that  is  divided 
into  two  questions  to  lesson  1  in  the  word  processing  CBI  is  an  example  of  this  type  of  change  and 
is  illustrated  in  Figure  18, 

The  procedure  for  adding  a  directory  to  the  courseware  directory  tree  is  presented  in  Table  7. 
Removing  a  Directory  from  the  Courseware  Directory  Tree 

If  you  choose  to  remove  an  item  from  the  instructional  outline,  you  may  have  to  remove  a  directory 
from  the  courseware  directory  tree.  If  the  item  you  want  to  remove  is  not  divided  into  other  items, 
you  have  only  to  remove  the  storyboard  file  that  corresponds  to  the  item.  Removing  a  question 
from  the  drill  in  the  word  processing  example  illustrates  this  type  of  change.  However,  if  the  item 
you  want  to  remove  is  divided  into  other  items,  you  must  remove  the  directory  and  courseware  files 
that  correspond  to  the  item.  Removing  the  item  called  “drill”  in  the  word  processing  example  il¬ 
lustrates  this  type  of  change. 

The  procedure  for  removing  a  directory  from  the  courseware  directory  tree  is  presented  in  Table  8. 


27 


Tables 


Adding  a  Storyboard  File 


_ Procedure  for  Adding  a  Storyfaoerd  Rle 

1.  Create  the  new  storyboard  file.  •  Move  to  the  directray  that  will  contain  the  new  stoyboaid  file. 

•  Use  your  word  processor  to  create  the  new  storyboard  file.  Save  the 
new  storyboard  file  as  a  non-document  or  ASCII  file. 


2.  Build  the  segment  for  the  new  •  UseCATSC  to  build  a  segment  for  the  new  storyboard  file. 

storyboard  file.  •  Watch  fw  any  compilation  cnxMS.  If  there  are  such  ema^,  reedit  the 

storyboard  file  and  then  go  back  to  the  beginning  of  step  2  to  rebuild 
the  segment. 

•  Check  the  size  of  the  segment  file  and  any  graphic  or  animation  files 
that  it  requires.  Graj^c  ot  animation  files  larger  than  360  kilobytes 
are  currently  not  distributable.  If  there  are  any  files  larger  than  360 
kiIob>tes,  you  may  have  to  alter  the  DISTRIB.BAT  file  for  the 
directory.  Follow  the  instructions  in  Appendix  C,  Handling 
Presentation  Disk  Size  Constraints. 


3.  Test  the  new  segment.  •  Use  CATSVIEW  to  view  the  new  segment  and  verify  that  its  screens, 

branches,  data  collection,  etc.,  are  cturecL 

4.  Locate  every  batch  file  •  Determine  which  batch  files  should  be  updated.  (St^  4  focuses  on 

affected  by  this  change.  locating  the  batch  files  that  are  affected  by  adding  a  storyboard  file. 

Step  5  covers  the  changes  that  should  be  made  to  these  batch  files.) 

To  locate  the  affected  batch  files: 

a.  Begin  in  the  directory  where  the  new  storyboard  resides.  The 
BUILD.  BAT  and  QBUI LD .  BAT  files  in  this  directory  must 
be  updated. 

b.  Move  up  one  directory.  The  BUILD.  BAT  batch  file  in  this 
directcMy  must  be  updioed.  Continue  to  update  the  build,  bat 
files  until  you  teach  the  topmost  directory  in  the  CBI  directory  tree. 

Steps  a  and  b  define  a  path  of  directories  beginning  with  the  directory 
where  the  new  storyboard  resides  and  continuing  to  the  topmost 
directory  in  the  dirwtory  tree.  Each  build  .  BAT  file  in  this  path 
mustbeupdated.  In  addition,  theQBUlLD.BAT  file  in  the  directory 
where  the  storyboard  resides  must  be  updated. 

Fot  example.  Figure  17  illustrates  the  batch  files  at  each  level  that 
must  be  updated  if  a  storyboard  called  QUES 1 1  is  added  to  ttie 
directory  DRILL.  The  highlighted  area  represents  the  path  from  the 
directory  containing  the  new  storyboard  to  the  topmost  directory  in  the 
CBI  direcUNT  tree.  Each  BUILD .  BAT  file  along  this  path  must  be 
iqxlated.  In  addition,  the  QBUILD .  BAT  in  the  DRILL  directmy 
_  _ must  be  updated. _ _ 
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Table  5  (Continued) 


Procedure  for  Adding  a  Storyboard  File 

S.  Update  every  batch  file 
affected  by  this  change. 

•  Update  each  batch  file.  To  do  this  you  must  know  how  the  batch  file 
works.  Appendix  A  describes  in  detail  how  BUILD .  BAT  and 
QBUILD.BAT  work. 

• 

ForcachBUlLD.BAT  that  is  affected  you  should: 

*  Add  a  command  that  builds  a  segment  file  for  the  new  storyboard 
file. 

*  Add  a  command  that  places  the  storyboard  file’s  segment  into  the 
package  segment  that  resides  in  the  same  directory  as  the  new 
storyboard  file. 

For  the  QBUILD .  BAT  that  is  afiiected  you  should: 

*  Add  a  command  that  places  the  storyboard  file’s  segment  into  the 
package  segment  that  resides  in  the  same  directory  as  the  new  story¬ 
board  file. 

6.  Test  every  batch  file 
affected  by  this  change. 

•  Execute  each  updated  batch  file  and  verify  that  its  modifications,  screens, 
data  collection,  etc.,  are  ccOTect.  Check  all  branch  paths  in  the  updated 
segment  files.  Make  sure  that  a  storyboard  does  not  branch  to  an  incor¬ 
rect  or  nonexistent  event. 

•  Executing  each  updated  batch  will  also  give  you  the  opportunity  to  verify 
that  the  new  storyboard  file  does  not  conflict  with  the  rest  of  the 
courseware  in  the  directory  tree. 
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Figure  17.  Each  BUILD .  BAT  file,  from  the  directory  containing  the  new  storyboard 
to  the  topmost  directory  in  the  CBI  directory  tree,  must  be  updated. 
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Table  6 


Removing  a  Storyboard  File 

_ _ Procedure  for  Removing  a  Storyboard  File _ 

1.  Remove  the  storyboard  file.  •  Move  to  the  directory  that  contains  the  storyboard  file. 

_ «  Remove  the  storybo^  file. _ 

2.  Locate  every  batch  file  •  Determine  which  batch  files  should  be  updated.  (Step  2  focuses 

affected  by  this  change.  on  locating  the  batch  files  that  are  affected  by  removing  a  storyboard  file . 

Step  3  covers  the  changes  that  should  be  made  to  these  batch  files.)  To 
locate  the  affected  batch  files: 

a.  Begin  in  the  directory  where  the  storyboard  file  resided.  The 
BUILD.  BAT  and  QBUI LD .  BAT  files  in  this  directory  must  be 
updated. 

b.  Move  up  one  directory.  The  build,  bat  file  in  this  directory  must 
be  updated.  Continue  to  update  the  BUILD .  BAT  files  until  you 
reach  the  topmost  directory  in  the  CBI  directory  uee. 

Steps  a  and  b  define  a  path  of  directories  beginning  with  the  director)’ 
where  the  storyboard  resides  and  continuing  to  the  topmost  director)' 
in  the  CBI  directory  tree.  Each  BUILD.  BAT  file  in  this  path  must  be 
updated.  In  addition,  the  QBUILd  .  bat  file  in  tlie  directory  where  the 
_ stoiyboard  resides  must  be  updated. _  _ 

3.  Update  every  batch  file  •  Update  each  batch  file. 

affected  by  this  change.  To  update  a  batch  file  you  need  to  know  how  the  batch  file  works.  See 

Appendix  A  for  detailed  information  about  the  BUILD .  BAT  and 
qbuild.bat  files. 

For  each  BUILD .  BAT  that  is  affected  you  should: 

•  Remove  the  command  that  builds  a  segment  for  the  storyboard  file. 

•  Remove  the  command  that  places  the  storyboard  file’s  segment  into  the 
package  segment  that  resides  in  the  same  directory  as  the  storyboard  file. 

For  the  QBUILD .  BAT  that  is  affected  you  should: 

•  Remove  the  command  that  places  the  storyboard’s  segment  into  the 

_ _ package  segment  that  resides  in  the  same  directory  as  the  storyboard  file. 

4.  Test  every  batch  file  •  Execute  each  updated  batch  file  and  verify  that  its  modifications, 

affected  by  this  change.  screens,  data  collection,  etc.,  arc  correct  Check  all  branch  paths 

in  the  updated  segment  files.  Make  sure  that  a  storyboard  doesn’t 
branch  to  an  incorrect  or  nonexistent  event. 

•  E.'"*''uiing  each  updated  batch  will  also  give  you  the  opportunity  to 
ven  that  removing  the  storyboard  file  does  not  conflict  with  the 

_ rest  of  the  courseware  in  the  directory  tree. 
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Figure  18.  Adding  a  directory  to  the  courseware  directory  tree. 
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Table  7 


Adding  a  Directory  to  the  Courseware  Directory  Tree 


Procedure  for  Adding  a  Diiectory  to  the  Courseware  Directory  Tree 


1.  Add  the  Kw 
directory  to  the 
4>propriatepartof 
the  dirotory  tree. 

2.  Create  the 
storyboard.  gng>hic, 
and  animation  files. 

3.  Build  segment 
files  for  the  new* 
storyboard  files 


4.  Test  the  new 

segment  files. _ 

5  CreateaBUlLD.BAT 
and  ut3UlLD.BAT  file 
for  the  new  directory. 


•  Move  to  the  directory  that  will  contain  the  new  subdirectory. 

•  Create  the  new  subdirectory. 


•  Move  to  the  new  directory. 

•  Create  the  new  storyboard,  gi^ihic,  and  animation  files. 


•  Use  CATSC  to  build  the  segments  for  each  new  storyboard  file. 

•  Watch  for  any  compilation  errors.  If  there  are  such  errors,  reedit  the 

appropriate  storyboard  files  to  fix  the  errors,  then  go  back  to  the  beginning 
of  step  3  to  rriiuild  the  segments  for  those  storyboard  files. _ 

•  Use  CATSViEW  to  test  the  new  segment  files  and  to  verify  that  the  new 

graphic  and  animation  files  are  correct _ _ 

•  CreateaBUlLD.BAT  for  the  new  directory.  The  easiest  way  to  create 

a  new  batch  file  is  to  alter  a  cq>y  of  an  existing  batch  file,  preferably  one 
that  belongs  to  a  similar  directory.  Find  an  existing  BUI LD .  BAT  file  and 
copy  it  into  the  new  directory. 

•  Edit  the  new  BUILD .  BAT  file  and  revise  its  DOS  commands  to  build 
segments  for  the  new  storyboard  files  and  to  build  the  package  segment  for 
the  new  directory.  Save  die  BUI  LD .  BAT  file  as  a  nondocument  or  ASCII 
file. 

•  Create  a  QBUILD.  BAT  forthe  new  directory.  Again,  the  easiest  way  to 
^Teate  this  new  batch  file  is  to  alter  a  copy  of  a  similar  one. 

•  rditiheQBUIu:>.BAT  file  with  your  word  processOT  and  revise  its  DOS 
commands  to  build  the  package  segment  for  the  new  directory.  Save  the 
PBUILD .  BAT  file  as  a  nondocument  or  ASCII  file. 


6.  If  the  courseware  in  •  Try  to  use  a  copy  of  an  existing  DI5TRIB.BAT  file  as  your  starting  point, 

the  new  directory  For  more  information  about  creating  a  DISTRIB .  bat  file,  see  the  insuuc- 

must  be  distributed,  tions  for  making  distributable  courseware  in  Table  2. 

create  a  distrib  .  bat 

file  for  the  directory. _ _ _ 

7.  T«t  all  the  new  •  Execute  the  new  batch  files  to  verify  that  they  are  correct  and  to  verify 

batch  files. _ that  the  new  directory’s  package  segment  is  correct. _ 

8.  Locate  any  existing  •  Determine  which  batch  files  should  be  iqxlated.  (Step  8  focuses  on  locating 

batch  files  that  are  the  files  that  are  affected  by  adding  a  directory  to  the  courseware 

affected.  directory  tree.  Stq?  9  covers  the  changes  that  ^ould  be  made  to  these  batch 

files.)  To  locale  die  affected  batch  files; 

a.  Move  up  one  directory.  The  BUILD.  BAT ,  QBUI  LD .  BAT,  and 
distrib  .  BAT  files  must  be  updated. 

b.  Moveuponedirectory.TheBUILD.BAT  andDISTRIB.BAT  files 
in  this  directory  must  be  updated.  Continue  this  step  until  you  reach  the 
topmost  directory  in  the  courseware  directory  tree. 


Steps  a  and  b  define  a  path  of  directories  beginning  with  the  directory 
dirtily  above  the  new  directory  and  continuing  to  the  topmost  directory  in 
the  CBl  directory  tree. _ _ 
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Table  7  (Continued) 

Procedure  for  adding  a  DirecbHy  to  the  Courseware  Directory  Tree 

9.  Update  the  affected 
batch  files. 

•  To  update  the  batch  files,  you  must  know  how  batch  files  work,  ^pendix  A 
describes  in  detail  how  BUILD. BAT  andQBUILD.BAT  wtMk.  Appendix 
B  describes  in  detail  how  DISTRIB .  bat  works. 

•  Once  you  have  added  a  new  directory,  you  must  add  DOS  commands  that 
reference  the  new  duectairy’s  package  segment  and  any  graphic  or  animation 
files  in  the  new  directory. 

For  each  build  .  bat  that  is  affected  you  should: 

•  Add  commands  to  build  segments  for  the  new  storyboard  files. 

•  Add  a  command  to  build  a  package  segment  for  the  new  directory. 

•  Revise  the  command  that  builds  the  package  segment  for  the  directory 
directly  above  die  new  directory  to  include  the  package  segment  for  the 
new  directory. 

For  the  QBUILD .  BAT  that  is  afi^ected,  you  should: 

•  Revise  the  command  that  builds  the  package  segment  for  the  directory 
directly  above  the  new  directory  to  include  the  package  segment  for  the 
new  directory. 

For  each  distrib.bat  that  is  affected  you  should: 

•  Add  commands  that  copy  any  new  graphic  or  animation  files  to  the 
INSTALL  directory. 

10.  Test  all  the 

updated  batch  files. 

•  Execute  each  updated  batch  file  to  verify  that  it  is  correct. 

•  Executing  each  updated  batch  will  also  give  you  the  opportunity  to  verify  that 
the  package  segment  for  the  new  directory  does  not  conflict  with  the  rest 

of  the  courseware  in  the  directory  tree. 
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Tables 


Removing  a  Directory  from  the  Courseware  Directory  Tree 


1.  Remove  the 
directory. 


Procedure  for  Removing  a  Directory  from  the  Courseware  Directory  Tree _ 

•  Move  to  the  directory  that  needs  to  be  removed. 

•  Remove  all  files  in  the  directory. 

•  Move  iQ)  to  the  directory  immediately  above  the  directory  you  want  to 
remove. 

_ «  Remove  the  directory. _ _ 


2.  Locate  any  existing  •  Determine  which  batch  files  should  be  u|xlated.  (Step  2  focuses  on 

batch  files  that  are  locating  the  batch  files  that  are  affected  by  removing  a  directory  from  the 

affected.  courseware  directory  tree.  Step  3  covers  the  changes  that  should  be 

made  to  these  batch  fikts.)  To  locate  the  affected  batch  files; 

a.  Update  the  BUILD.  BAT,  QBUlLD.BAT.andDlSTRlB.SAT  files  in 
the  current  directory. 

b.  Move  up  one  directory.  Any  BUi  ld  .  bat  and  Dl  strib  .  bat  files  in 
this  directory  must  be  updated.  Continue  this  step  until  you  reach  the 
topmost  directory  in  the  CBI  directory  tree. 


Steps  a  and  b  defitte  a  path  of  directories  beginning  with  the  directory 
directly  above  the  removed  directory  and  continuing  to  the  topmost  directory 
in  the  CBI  directory  tree.  All  batch  files  in  the  directory  directly  above 
the  removed  directory  must  be  iqxlated.  In  addition,  any  build,  bat  and 
_ PI  STRIB .  BAT  file  in  the  path  must  be  updated. _ 

3.  Update  the  affected  •  To  update  the  batch  files,  you  must  know  how  batch  files  work.  Appendix  A 

batch  files.  describes  how  build  .  bat  and  qbui ld  .  bat  work.  Appendix  B 

describes  how  DISTRIB.BAT  works. 


Once  you  have  removed  a  directory,  remove  the  DOS  commands  that 
reference  the  directory’s  package  segment  and  any  graphic  or  animation  files 
that  were  in  the  directory. 

For  the  BUILD .  BAT  that  is  affected  you  should; 

•  Remove  all  references  to  the  eliminated  files  and  directories. 

For  the  QBUI  LD .  bat  that  is  affected  you  should; 

•  Remove  all  references  to  the  eliminated  files  and  directories. 

For  each  DISTRIB.bat  that  is  affected  you  should: 

»  Remove  all  references  to  the  eliminated  files  and  directories. _ 

4.  Test  all  the  •  Execute  each  updated  batch  file  to  verify  that  it  is  correct 

updated  files.  •  Executing  each  updated  batch  file  will  also  give  you  the  opportunity  to 

verify  that  removing  the  directory  docs  not  conflict  with  the  rest  of  tlie 
_  courseware  in  the  directory  tree. 
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GLOSSARY 


To  avoid  ambiguity,  the  key  terms  used  in  the  CATS  maintenance  process  are  defined  below. 
These  definitions  have  been  adapted  specifically  for  this  document.  They  may  therefore  be  more 
restrictive  than,  or  different  from,  commonly  accepr*.d  definitions  for  these  terms. 

Ascn 

American  Standard  Code  for  Information  Interchange.  A  widely  accepted  standaid  for  encod¬ 
ing  alphanumeric  data. 

Animation  file 

A  file  containing  an  animation  sequence.  Animation  files  are  created  by  courseware  authors  us¬ 
ing  special  programs  called  animation  editors  such  as  “Show  Parmer”  and  “Grasp.” 

Authoring  tool(s)  or  authoring  system 

A  software  program  (or  programs)  designed  to  produce  and  maintain  CBI,  e.g.,  CATS. 

Batch  file 

A  text  file  that  contains  a  sequence  of  DOS  commands.  When  the  batch  file  is  executed,  its 
DOS  commands  are  perfonned  in  the  order  that  they  appear  in  the  batch  file. 

3UILD.BAT 

A  DOS  batch  file  that  resides  in  every  directory  within  the  courseware  directory  tree.  This 
batch  file  is  designed  to  build  the  segment  file  for  the  directory  and  all  of  its  subdirectories. 

CATS 

CBI  Authoring  Tools  System.  A  Government-owned  authoring  system.  CATS  includes:  (1)  A 
program  named  CAT  SC  that  converts  storyboards  into  segments.  (2)  a  program  named  CATSM 
that  binds  segments,  and  (3)  a  program  named  CATSVIEW  that  displays  segments,  graphic 
files,  and  animation  files  as  CBI. 

CATSC 

An  acronym  for  the  CATS  compiler;  a  program  in  CATS  that  compresses  and  encodes  ASCII 
storyboards  into  segments. 

CATSM 

An  acronym  for  the  CATS  multiple  segment  linker,  a  program  in  CL\TS  that  binds  two  or  more 
segments. 

CATSVIEW 

A  program  in  CATS  that  displays  segments,  graphic  files,  and  animation  files  as  CBI. 
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CBl 

Computer-based  instruction.  Instruction  or  training  delivered  on  a  computer.  Sometimes  re¬ 
ferred  to  as  computer-assisted  learning  (CAL)  or  computer-assisted  instruction  (CAI). 

Courseware  author 

A  person  who  creates  CATS  courseware. 

Courseware  directory  tree 

A  directory  structure  used  to  organize  CATS  courseware  fdes. 

Courseware  files 

The  computer  files  used  to  create  and  present  CBI  with  CATS.  There  are  two  types  of  course¬ 
ware  files:  (1)  source  files  and  (2)  presentation  files. 

DISTRIB.BAT 

A  DOS  batch  file  that  resides  in  a  directory  that  represents  a  distributable  portion  of  the  course¬ 
ware  within  the  courseware  directory  tree.  Tliis  batch  file  is  designed  to  build  the  presentation 
disks  for  the  courseware  in  the  directory. 

Distributable  courseware 

Portions  of  the  courseware  in  a  courseware  directory  tree  that  can  be  separately  and  autono¬ 
mously  placed  on  floppy  disks  and  distributed  to  students.  A  courseware  author  designates  the 
distributable  courseware  of  a  courseware  directory  tree  as  part  of  the  courseware  design  pro¬ 
cess.  A  directory  in  the  courseware  directory  tree  that  represents  distributable  courseware  will 
always  contain  a  DI STRIB .  BAT  file.  This  is  the  batch  file  that  builds  presentation  disks  for 
distributable  courseware. 

Graphic  file 

A  file  containing  a  graphic  image.  Graphic  files  are  created  by  courseware  authors  using  spe¬ 
cial  programs  called  graphic  editors.  “Dr.  Halo,”  produced  by  Media  Cybernetics,  and  “PC- 
Paintbrush,”  produced  by  Z-soft  Corporation,  are  two  examples  of  graphic  editors  that  produce 
graphic  files. 

Instructional  outline 

An  organiz  ‘  o:;  of  courseware  material  that  divides  information  into  items  and  subitems.  Items 
in  an  instructional  outline  can  be  topics  of  information  such  as  “Basics  of  Word  Processing”  or 
“U.S.  History,”  or  instructional  tools  such  as  tests,  drills,  lessons,  etc. 

Presentation  disk 

A  presentation  disk  contains  the  presentation  files,  or  a  subset  of  the  presentation  files,  used  to 
present  CBl.  Presentation  disks  contain  the  CATS  presentation  software,  lesson  segment  files, 
profile  files,  graphic  files,  and  animation  files.  One  of  the  presentation  disks  contains  only  the 
profile  files.  This  disk  is  called  the  student  disk. 
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Presentation  flies 

All  of  the  computer  files  required  to  present  CBI.  Includes  CATS  presentation  software,  lesson 
segment  files,  profile  files,  DIR  files,  graphic  files,  and  animation  files.  (Note:  Graphic  files 
and  animation  files  are  also  source  files.) 

Presentation  software 

A  software  program  that  presents  CBI.  For  example,  the  CATS  presentation  program  for  your 
lesson  is  called  EGA .  EXE . 

QBUILD.BAT 

A  DOS  batch  file  that  resides  in  every  directory  within  the  courseware  directory  tree.  This 
batch  file  is  designed  to  build  the  segment  file  for  the  directory  using  the  existing  segment  files 
in  its  directory.  (Note:  Because  this  batch  file  is  designed  to  run  quickly,  it  will  build  only  the 
segment  file  for  its  directory.  Unlike  BUILD .  BAT,  it  will  not  build  segment  files  for  any  sub¬ 
directories.) 

Segment  file  (or  Segment) 

A  presentat'on  file  produced  by  CAT  SC  that  is  an  encoded  and  compressed  version  of  a  story¬ 
board  file  or  a  collection  of  storyboard  files. 

Source  disk 

A  source  disk  contains  the  source  files  for  a  CBI  lesson,  or  a  subset  of  the  source  files  since  the 
source  files  together  may  exceed  the  capacity  of  a  single  disk. 

Source  files 

Source  files  are  computer  files  used  to  create  and  maintain  CBI  using  CATS.  Storyboard  files, 
graphic  files,  animation  files,  batch  files,  and  CATS  variable  files  are  source  files.  (Note: 
Graphic  and  animation  files  are  also  presentation  files.) 

Storyboard 

A  description  of  one  screen  and/or  one  operator  interaction  in  CATS  courseware.  Storyboards 
are  stored  in  storyboard  files. 

Storyboard  file 

An  ASen  file  that  contains  one  or  more  stt^boards  and  is  made  using  a  text  editor  or  word 
processing  program.  Storyboard  files  are  source  files  and  contain  the  basic  building  blocks  of 
the  lesson.  They  contain  information  that  controls  what  the  student  sees  on  the  screen,  how  the 
CBI  will  react  to  student  responses,  what  data  an;  collected  by  the  CBI,  and  the  lesson  support 
files  used  by  the  CBI. 

Student  disk 

A  student  disk  is  a  presentation  disk  that  contains  only  the  profile  files  (i.e.,  PROFILE .  CAT 
and  PROFILE  .FIX  files).  Each  student  needs  his  or  her  own  copy  of  this  disk  to  run  each 
lesson.  A  student  disk  is  used  as  a  repository  for  individual  student  data.  The  PROFILE .  CAT 
file  on  an  individual  student  disk  will  be  updated  automatically  to  reflect  the  student’s  progress 
during  the  student’s  use  of  the  lesson. 
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HOW  BUILD .  BAT  AND  QBUILD .  BAT  WORK 


BUILD .  BAT  and  QBUILD .  BAT  are  batch  files  that  build  segment  files  for  a  directory.  Course¬ 
ware  authors  create  these  files  for  every  directory  in  the  courseware  directory  tree.  Batch  files  make 
it  easy  to  build  segment  files.  By  using  batch  files,  the  courseware  developer  only  has  to  type  one 
command  (either  BUILD .  BAT  or  QBUILD .  BAT)  instead  of  remembering  a  whole  series  of  com¬ 
mands. 

BUILD, BAT 

The  objective  of  the  BUILD .  BAT  file  is  to  build  the  segment  file  for  its  directory  from  scratch.  To 
do  this,  BUILD .  BAT  performs  the  following  steps: 

1 .  Removes  all  segment  files  from  the  current  directory  and  any  subdirectories  of  the  current 
directory. 

2.  Builds  new  segment  files  for  all  the  storyboard  files  in  the  subdirectory. 

3.  Builds  a  new  package  segment  for  the  subdirectory. 

4.  Builds  a  new  package  segment  for  the  current  directory. 

Each  of  these  steps  is  accomplished  by  one  or  more  DOS  commands  in  the  BUILD .  BAT  file. 
When  the  batch  file  is  execut^,  the  DOS  commands  are  executed  in  the  order  that  they  appear  in 
the  batch  file. 

All  BUILD .  BAT  batch  files  have  the  same  objectives,  and  they  use  the  same  steps  to  reach  their 
objectives.  However,  since  BUILD .  BAT  files  reside  in  different  parts  of  the  directory  tree,  they 
will  use  slightly  different  DOS  commands  to  accomplish  these  steps.  To  describe  in  detail  how 
BUILD.  BAT  flics  work,  we  will  discuss  the  DOS  commands  used  by  one  BUILD,  BAT  file  in  the 
word  processing  example.  Keep  in  mind  the  steps  that  all  BUILD .  BAT  files  must  accomplish 
while  we  discuss  the  specific  DOS  commands  in  the  example. 

Figure  A-1  illustrates  a  portion  of  the  courseware  directory  tree  for  the  word  processing  CBI.  We 
will  use  the  BU I LD .  BAT  file  in  the  TOP  I C 1 A  directory  as  our  example. 
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Figure  A-1.  The  BUILD . BAT  and  QBDILD .  BAT  flies  for  the  TOPICIA  di¬ 
rectory  will  build  the  package  segment  called  TOPICIA .  SEG . 

Figure  A-2  shows  the  contents  of  this  BUILD .  BAT  file.  The  numbers  to  the  left  of  each  line  in  the 
BUILD .  BAT  file  are  called  “line  numbers.” These  line  numbers  are  referenced  below  in  describ¬ 
ing  what  the  DOS  commands  do. 

Lines  1-16  Presents  information  to  the  user  telling  what  the  batch  file  will  do.  Gives  the  user 
the  option  of  quitting  or  continuing.  (The  echo  features  allow  the  user  to  see  or 
not  to  see  what  commands  are  being  executed  in  the  batch  file.) 

Lines  17  -  20  Removes  all  the  segment  files  that  this  batch  file  is  about  to  rebuild.  If  these  seg¬ 
ment  files  were  not  removed  and  the  batch  file  were  stopped  before  completion, 
the  user  might  then  accidentally  use  an  old  version  of  a  segment  file. 
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1 

2 

3 

U 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 


tcho  off 
•cho  , 

•Cho  BUILO.SAT  for  the  \U0RDP\LESS0M1\T0P1C1A  Segment 

echo  BETA  TEST  VERSION  0.2 

echo  14  Her  1989 

echo  . 

echo  This  batch  file  Mill  build  TOPIC1A.SEC  by  compiling  end  linking 
echo  ell  the  comMSites  in  \WOADP\LESSON1\TOPfciA. 
echo  . 

echo  Error  siesseget  Mill  be  esved  in  a  file  celled  BLD-ERRS. 
echo  . 

echo  WARNING:  All  existing  segments  Mill  be  removed! 
echo  . 

echo  Hit  (Returni  to  continue,  ICtrl-C)  to  stop. 

pause 

echo  on 


17  del  Hordp\leston1\topic1s\*.seg 

'<8  del  Mordp\leston1\topie1s\drilT\*.seg 

19  del  Hordp\leston1\topic1a\test\*.seg 

20  del  iiorclp\leston1\topic1s\prsct\*.seg 


21  set  catsvarse\Mordp\cvars 


22  cd\uorclp\lcsson1\topic1a\drill 


23  eatsc  etuesi  >  \uordpMcston1\topic1s\bld-errs 

24  catse  ques2  >>  \wordp\tesson1\topic1a\bld-errs 

25  catsc  oues3  »  \wordp\tesson1\topic1a\bld-errs 

26  catsc  oues4  >>  \wordp\lesson1\topic1s\bld-errs 

27  catsc  quesS  >>  Vuordp\lcsson1\topic1a\btd-errs 

28  catsc  ques6  »  \wordp\lesson1\topic1a\bld*errs 

29  catsc  pues7  >>  \Mordp\lesson1\topic1a\bld-errs 

30  catsc  quesS  >>  \wordp\lessoni\topic1a\bld-errs 

31  catsc  ques9  >>  \wordp\lesson1\topic1a\bld-errs 

32  catsc  quesin  »  \wordp\tesson1\topic1a\l;ld-errE 


33  catsc  t1  quesl.seg  ques2.6eg  quesS.seg  »  \wordp\leston1\topic1a\bld-errs 

34  catsc  t2  tl.seg  queB4.seg  quesS.seg  »  \wordp\lesson1\topic1a\bld-errs 

33  catsc  t3  t2.seg  quesO.seg  ques7.seg  >>  \wordp\lesBon1\topic1a\bld*errs 

36  catsc  t4  t3.seg  quesS.seg  ques9.seg  »  \wordp\lesson1\tobic1a\bld-errs 

37  catsc  drill  t4.seg  queslO.seg  »  \wordp\lesson1\topic1a\bld*errs 


38 

39 

40 

41 


del  tl.seg 
del  t2.seg 
del  t3.$eg 
del  t4.seg 


42  cd  \wordp\lesson1\topicl8\test 


J  catsc  quesi  »  \Mordp\lesson1\tepic1a\bld-errs 
<  catsc  ques2  »  \Mordp\lesson1\topic1a\bld-errs 
5  catsc  ques3  >>  \uordp\lessen1\topic1a\bld-errs 
i  catsc  ques4  >>  \wordp\lesson1\topic1a\bld-errs 


47  catsc  t1  quesl.seg  ques2.se9  quesS.seg  \wQrdp\lesson1\topic1s\bld-errs 

48  catsc  test  tl.seg  ques4.seg  »  \wordp\les5on1\topicl8\bld-errs 


49  del  tl.seg 


50  cd  \wordp\tcsson1\topic1e\pract 


51  catsc  pracl  >>  \wordp\tesson1\topicl8\bld-errs 

52  catsc  prac2  >>  \uordp\letson1\topic1a\bld-errs 

53  catsc  prac3  »  \Mordp\lessor.1\topic1a\bld-errs 

54  catsc  prsc4  »  \MordpMesson1\topic1a\bld-errs 


55  catsc  t1  pracl. seg  prBc2.seg  prac3.seg  »  \werdp\lessonl\iopic1a\bld-errs 

56  catsc  pract  tl.seg  prsc4.seg  »  \wordp\lesEon1\topic1a\bld*errs 


57  del  tl.seg 


58  cd\uordp\lcsson1\topic1a 


59  copy  \wordp\lessonl\topic1a\driii\drilUseg 

60  copy  \wordpMessonl\topicla\test\teBt.se9 

61  copy  \wordp\lesson1\topic1a\prsct\prsct.seg 


62  eatsc  topicia  drill. seg  test. seg  pract. seg  »  bld-errs 


63  mere  <  bld*errs 


Figure  A-2.  BUILD .  BAT  files  contain  DOS  commands  to  build  a  directory's 
segment  file  from  scratch. 
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Line  21 

Line  22 

Lines  23  -  32 

Lines  33  -  37 

Lines  38  -  41 

Line  42 
Lines  43  -  46 

Lines  47  -  48 

Line  49 

Line  50 
Lines  51-54 

Lines  55  -  56 


Sets  the  CATS  variable  file  location  as  WORDP  \CVARS .  This  enables  CAT  SC  to 
locate  the  CATS  author  variables  for  the  word  processing  CBI. 

Moves  to  a  bottom-level  subdirectory  called  DRILL .  BUILD ,  BAT  starts  at 
the  lowest  level  of  subdirectories  and  proceeds  to  build  segment  Hies  from  the 
“bottom  up.”  This  is  because  segment  files  in  the  upper  subdirectories  are  pack¬ 
ages  of  the  segments  from  their  lower  subdirectories. 

Builds  segment  files  for  each  storyboard  file  in  the  DRILL  subdirectory.  Any 
compilation  errors  will  be  copied  to  a  file  called  BLD-ERRS  in  the  TOPICIA 
directory.  (The  “>”  and  “»”  are  parts  of  DOS  commands  that  cause  messages 
from  a  program  to  be  sent  to  a  text  file.) 

Builds  a  package  segment  DRILL .  SEG  for  the  DRILL  subdirectory.  Any  com¬ 
pilation  errors  will  be  copied  to  a  file  called  BLD-ERRS  in  the  TOPICIA  direc¬ 
tory. 

Removes  the  temporary  segment  files  that  were  created  during  the  process  of 
building  the  DRILL .  SEG  package  segment.  (DOS  commands  must  fit  on  only 
one  line.  Therefore,  CAT  SC  commands  are  sometimes  broken  up  and  the  inter¬ 
mediate  segments  are  placed  in  temporary  files.) 

Moves  to  another  bottom-level  subdirectory  called  TEST. 

Builds  segment  files  for  each  storyboard  file  in  the  TEST  subdirectory.  Any  com¬ 
pilation  errors  will  be  added  to  the  BLD-ERRS  file  in  the  TOPICIA  directory. 

Builds  a  package  segment  TEST .  SEG  for  the  TEST  subdirectory.  Any  compi¬ 
lation  errors  will  be  copied  to  the  BLD-ERRS  file  in  the  TOPICIA  directory. 

Removes  the  temporary  segment  file  that  was  created  during  the  process  of  build¬ 
ing  the  TEST ,  SEG  package  segment. 

Moves  to  the  last  bottom-level  subdirectory  called  PRACT. 

Builds  segment  files  for  each  storyboard  file  in  the  PRACT  subdirectory.  Any 
compilation  errors  will  be  copied  to  the  BLD-ERRS  file  in  the  TOPICIA  direc¬ 
tory. 

Builds  a  package  segment  PRACT .  SEG  for  the  PRACT  subdirectory.  Any  com¬ 
pilation  errors  will  be  copied  to  the  BLD-ERRS  file  in  the  TOPICIA  directory. 
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Line  57 


Line  58 


Removes  the  temporary  segment  file  that  was  created  during  the  process  of  build¬ 
ing  the  PRACT .  SEG  package  segment. 

Moves  to  the  next  highest  level  subdirectory  TOP  ICIA . 


Lines  59  -  61  Copies  the  package  segments  DRILL .  SEG,  TEST .  SEG,  and  PRACT .  SEG 
from  the  lower-level  subdirectories. 


Line  62  Builds  the  package  segments  DRILL.  SEG,  TEST.  SEG,  and  PRACT.  SEG  into 

a  package  segment  called  TOP  ICIA.  SEG.  Any  compilation  errors  will  be  copied 
to  the  BLD-ERRS  file  in  tlie  TOP  ICIA  directory.  (Since  this  command  is  being 
executed  in  the  TOPICIA  directory,  it  did  not  have  to  provide  a  full  path  name 
for  the  BLD-ERRS  file. 


Line  63  Displays  any  compilation  errors  on  the  screen  (via  the  DOS  MOKE  command). 


QBUILD.BAT 


The  objective  of  the  QBUILD .  BAT  file  is  to  quickly  build  the  segment  '’  le  for  its  directory  without 
rebuilding  any  of  the  segments  for  storyboard  files  or  subdirectories.  To  do  this,  the 
QBUILD.BAT  performs  the  following  steps: 

1,  Removes  the  package  segment  file  from  the  current  directory. 

2.  Builds  a  new  package  segment  for  the  current  dircctoi-y. 

Each  of  these  steps  is  accomplished  by  one  or  more  DOS  commands  in  the  QBUIl.D  .BAT  file. 
When  the  batch  file  is  executed,  the  DOS  commands  are  executed  in  the  order  in  which  they  appear 
in  the  batch  file. 


Like  BUILD . BAT  files,  all  QBUILD . EAT  batch  files  use  slightly  different  DOS  contmands  to 
reach  the  same  objective.  The  following  example  describes  ir.  detail  bow  QBUILD.BAT  files 
work,  discussing  the  DOS  commands  u.vrd  by  one  QBUILD .  BAT  file  in  the  word  processing  ex¬ 
ample.  Again,  keep  in  mind  the  objective  of  all  QBUILD .  BilT  files  whiic  looking  at  the  specific 
DOS  commands  in  the  example. 

Weusedthe  BUILD.BAT  file  from  the  TOP  I  CIA  directoi^' to  discuss  how  PUILD.BAT  files 
work.  Now  we  will  use  the  QBUILD.BAT  file  from  the  same  directory  as  out  example  for 
QBU I LD .  BAT  files.  Figure  A-3  shows  the  contents  of  this  QBU I LD .  BAT  file. 
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Lines  1  - 

Line  23 

Lirie  24 

Lines  25 

Line  28 
Line  29 


1  cchoc^f 

2  echo . 

3  echo  QBUILD.BAT  forlheVWORDPsLESSONlNTOPIClA  Segment 

4  echo  BETA  TEST  VERSION  0.2 

5  echo  14  Mu  1989 

6  echo . 

7  echo  Hus  bttch  file  will  build  7X3PIC1  A.SEG. 

8  echo . 

9  echo  Please  make  sure  that  all  the  stoiyboard  filet  have  been  compiled 

10  echo  BEFORE  using  this  batch  file  to  build  TCX*1C1A.SEG. 

11  echo . 

12  echo  YtKi  can  either  compile  the  noiyboaid  files  mdividually,  or  you 

13  echo  can  use  the  baidi  file  named  BUILD.BAT  to  coDi]ale  them  all 

14  echo  at  once. 

15  echo . 

16  echo  EnormeMagei  will  be  saved  in  a  file  called  BLD-ERRS. 

17  echo . 

18  echo  WARNING:  Any  existing  TQPICIA.SEG  will  be  leinovedi 

19  echo. 

20  echo  lilt  [Return]  to  continue,  (Qtl-C)  lo  stop. 

21  pause 

22  echo  on 

23  del  wcrdp''lessonI'wpicla\*.seg 

24  set  catsvars::;\wordp\cvsrs 

25  copySwordp'lessonlNiopiclsNdrillVlrill.seg 

26  copy\wordp^lessonl^topicltVesl^tesuteg 

27  copy\woidp'JessonlVo|)iclaNpractNpracuseg 

28  catsc  lopicl  <  dhll.seg  tastscg  practseg  >  bld^em: 

29  more  <  bld-errs 

Figure  A-3.  QBDILD.BAT  fiSes  contain  DOS  commands  to  quickly  build  a 
directory’s  segment  file. 


22  Presents  information  to  the  user  telling  what  the  batch  file  will  do.  Gives  the  user 
the  option  of  quitti.ng  or  continuing. 

Removes  the  package  segment  file  from  the  current  directory.  If  this  segment  file 
were  not  removed  and  the  batch  file  were  stopped  before  completion,  the  user 
might  then  accidentally  use  an  old  version  of  a  segment  file. 

Sets  the  CATS  variable  file  location  as  WORDPNCVAPS .  This  enables  CATSC 
to  locate  the  CATS  author  variables  for  the  word  processing  CBI. 

-  27  Copies  tlie  package  segments  DRI.l,L ,  SEG,  TEST ,  SEG,  and  PRAC r .  SEG 
from  the  lower-level  subdirectories. 

Builds  a  package  segment  TOPICIA.  SEG  for  the  TOPICIA  subdirectory. 
Displays  any  compilation  errors  on  the  screen  (via  the  DOS  MORE  command). 
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APPENDIX  B 

HOWOZSTRZB.BAT  ^ORKS 


B-0 


HOW  DZSTRZB.BXT WORKS 


The  objective  of  the  DISTRIB.BAT  file  is  to  build  presentation  disks  for  its  directory.  To  do  this 
the  DISTRIB .  BAT  performs  the  following  steps: 

1.  Creates  a  temporary  directory  called  INSTALL  that  will  contain  all  the  files  that  need  to 
be  placed  on  the  presentation  disks. 

2.  Copies  the  presentation  program  and  execution  batch  files  to  the  INSTALL  directory. 

3.  Copies  ail  the  graphic  and  animation  files  used  by  the  package  segment  to  the  INSTALL 
directory. 

4.  Copies  the  package  segment  and  the  profile  file  for  the  current  directory  to  the  INSTALL 
directory. 

5.  Executes  a  program  called  BLD_INST.EXE  that  will  calculate  how  many  presentation 
disks  are  needed,  format  the  presentation  disks,  then  copy  all  the  files  from  the  INSTALL  directory 
to  the  appropriate  presentation  disks. 

6.  Removes  all  the  files  in  the  INSTALL  directory,  then  removes  the  INSTALL  directory. 

Each  of  these  steps  is  accomplished  by  one  or  more  DOS  commands  in  the  DISTRIB .  BAT  file. 
When  the  batch  file  is  executed,  the  DOS  commands  are  executed  in  the  order  in  which  they  appear 
in  the  batch  file. 

All  DISTRIB . BAT  batch  files  have  the  same  objective  and  use  the  same  steps  to  reach  their 
objective.  However,  since  DISTRIB .  BAT  files  reside  in  different  parts  of  the  directory  tree,  they 
use  slightly  different  DOS  commands  to  accomplish  these  steps.  To  describe  in  detail  how 
DISTRIB.BAT  files  work,  the  following  pages  discuss  the  DOS  commands  used  by  one 
DISTRIB .  BAT  file  in  the  word  processing  example.  During  this  discussion  of  the  specific  DOS 
commands  used  by  the  example  DISTRIB . BAT,  keep  in  mind  the  steps  that  all  DISTRIB . BAT 
files  must  accomplish. 

Figure  B- 1  illustrates  the  location  of  a  distributable  portion  of  the  courseware  directory  tree  for  the 
word  processing  CBI.  Since  topic  lA  of  lesson  1  is  distributable,  its  directory  contains  the 
DISTRIB .  BAT  file.  Figure  B-2  shows  the  contents  of  this  DISTRIB .  BAT  file.  The  numbers 
shown  in  the  figure  for  each  line  in  the  DISTRIB .  BAT  file  are  called  "line  numbers.”  These  line 
numbers  are  used  below  to  isolate  commands  in  the  DISTRIB .  BAT  file  and  to  describe  what  these 
commands  do. 
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CJWOR0P\l€S«O»nTOI»JCtA 
Ivt.a  topic;  RuanwgihoProfttun 


TOPlC1A,SEd 

PROPS.ECAT 

tOPKtiADini 

8UILD.aAT 

QBUILO.BAT-; 


Tbls  OISTRIB.BAT  file  will  build  distribubon 
disks  for  the  TOPIC1A  director. 


Pft<»lLE.CAT 
-imLOIR 
■  BUlUf.BAt 


C:\WOROP\LESSCWWOPIC1  A\DRIl4i 
1,1^  i  Dr» 


QliESi 

QUES2 


QUES10 


OUES1.PJC 

OUES2.CUT 


OUE&10  PRO  w;.  OBUItO BAT 


CWORDPa.£SSOMt\TOPJClA\TEST 
1.1  a3  Test 


Figure B-1.  The  DISTRIB.EAT  file  for  the  TOPICIA  directory  that  will 
build  its  presentation  disks. 

Lines  1-18  Presents  information  to  the  user  telling  what  the  batch  file  will  do.  Gives  the  user 
the  option  of  quitting  or  continuing.  (The  echo  features  allow  the  user  to  see  or 
not  see  what  commands  are  being  executed.) 

Line  19  Makes  a  temporary  directory  called  INSTALL.  This  directory  will  be  used  as  a 

repository  for  all  the  files  that  must  be  placed  on  the  presentation  disks  for  the 
TOP  ICIA  directory. 

Lines  20-21  Copies  the  program  EGA .  EXE  that  presents  CBI  to  the  students  and  the  batch  file 
RUN_LES .  BAT  that  the  students  use  to  execute  the  CBI  to  the  INSTALL  di¬ 
rectory. 

Lines  22  -  24  Copies  all  the  graphic  and  animation  files  from  the  DRILL  directory  to  the  IN¬ 
STALL  directory. 

Lines  25 -27  Copies  all  the  graphic  and  animation  files  from  the  TEST  directory  to  the  IN¬ 
STALL  directory. 


Lines  28 

Line  31  - 

Line  33 
Lines  34 

Lines  46 
Lines  49 

Lines  52- 

Line  61 

Lines  62- 


-  30  Copies  all  the  graphic  and  animadon  files  from  the  PRACT  directoiy  to  the  IN¬ 

STALL  directory. 

32  Copies  the  TOPICIA.SEG  segment  file  and  the  PROFILE.  CAT  file  that  iden¬ 
tifies  the  segment  to  the  INSTALL  directory. 

Moves  to  the  INSTALL  directory  to  begin  building  presentation  disks. 

-  45  Presents  information  to  the  user  saying  that  the  generic  student  disk  is  about  to  be 

built.  Asks  the  user  to  place  the  genetic  student  disk  in  the  “a:”  drive. 

-48  Formats  the  generic  student  disk. 

-51  Places  the  PROF  I LE .  CAT  file  that  identifies  the  TOP  I C 1 A .  SEG  segment  onto 
the  generic  student  disk.  Makes  backup  copy  of  PROFILE .  CAT  and  names  it 
PROF  I  LE .  F 1 X .  Removes  the  P  ROF I  LE .  CAT  file  so  that  it  will  not  be  placed 
on  the  rest  of  the  presentation  disks. 

60  Presents  information  to  the  user  saying  that  the  rest  of  the  presentation  disks 
(which  are  installation  disks)  are  about  to  be  built. 

Executes  the  program  called  BLD_INST .  EXE ,  This  program  will  build  the  rest 
of  the  presentation  disks.  To  do  this,  it  will  first  determine  how  many  presentation 
disks  are  needed,  given  the  number  of  files  in  the  INSTALL  directory.  Then,  for 
each  presentation  disk,  it  will  ask  the  user  to  place  the  disk  in  the  “a:”  drive,  for¬ 
mat  the  disk,  and  copy  the  appropriate  files  to  the  disk. 

•70  Moves  to  the  TOP ICIA  directory,  removes  all  the  files  in  the  INSTALL  direc¬ 
tory,  then  removes  the  INSTALL  directory. 
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1  echo  off 

2  echo. 

3  echo  Build  iMtallation  Diiki  end  Generic  Student  Diik 

4  echo  BETA  TEST  VERSION  0.M 

5  echo  14  Mar  1989 

6  echo . 

7  echo . 

8  echo  Thii  batch  file  will  build  iwiallatiao  diikt  end  a  (eneric 

9  echo  student  diik  for  the  TCX’ICl  A  difectofy. 

10  echo . 

11  echo . 

12  echo  WARNING:  fie  loie  that  you  have  build  sp-io-daiese|n>eai  filet 

13  echo  for  the  diiecloiybefofe  you  oaelfait  batch  filel 

14  echo . 

15  echo  Hit  [Retum]  to  continue,  (Ctrl-C]  to  stop. 

16  echo. 

17  pause 

18  echo  on 

19  inkdir\woid|Neitonl'uapicla'^ttall 

20  copy^cats^bin^ega.exe\wotdpVeltonl^topicla^insta]l 

21  cupy  VcatjVbin\iun_Iet.bat  VwoidpVeasonlVopiclaVnttair^o.bat 

22  copy  \wordpMe8tanlNlopicla\drilN*.pic\wonlp'9esionlVaopicla>iiutaU 

23  copy  \wo^d(l^essanl^lopicla^drilN*.cut\wonlpVetlonl^topicla\i3MtaIl 

24  copy  \wordfMei  ton  IVtopic  1  a\dril]\*.pro  \word{Meifan  l^topic  1  aVnstall 

25  copy  NwordpNlesson  IVlopic  1  a'^teitX*  .pic  XwoidpMesicn  l^topic  1  a^install 

26  copy  XwoidfNeitonlVopicla'testN*  .can  ^vo!t^fleslcnl^tc^cla^ulltall 

27  cc^y  \word[hleisan  IVopic  1  aVettX*  .pro  VvordpVesson  IVtopic  1  aVniuU 

28  copy  XwordiNesianlViopiclaNpracri*  .pic  Xworc^MessonlNiopiclaNinttaU 

29  copy  \wotd|9deitan  lVtopiclaYracri*.cut\wofdp'9cstonl\U)piclaXinitall 

30  copy  NwordpMeison  l^to(BC  la'pracri*  .pro  Nwon^eitoi  IVtopic  la''iniiall 

3 1  copy  XwordiMeiion  INiopic  laVopic  1  a.seg  \wtmlp\letioa  IVtopicl  aNinitall 

32  copy  \word[Meiion  IVtopic  laVprofile.cat  Xwon^VlessonlVtopicl  aVinitall 

33  cdSwoidpVlessoniVtapicla'^iiall 

34  echo  off 

35  echo . 

36  echo . 

37  echo . 

38  echo  Building  a  generic  tuident  disk  for  the  TOPICIA  C31. 

39  echo . 

40  echo . 

41  echo . 

42  echo  Please  place  the  generic  student  disk  in  drive  A; 

43  echo . 

44  pause 

45  echo  on 

46  echo .  >  ret 

47  echo  n  » tel 

48  fonnat  a:  <  let 

Figure  B-2.  Listing  of  the  DISTRIB.BAT  file  that  contains  DOS  commands 
to  build  presentation  disks  for  the  TOPICIA  directory. 
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49  C()pypr(rfik.Mta; 

50  copy  profile-cu  •:pn^.fix 

51  delpnifikxit 

52  echo  off 

53  echo. 

54  echo . 

55  echo. 

56  echo  BuiUnffafUllaUaaciiAiforibeTOnaACBL 

57  echo. 

58  echo. 

59  echo . 

60  eiiioon 

61  bldJiiK.eie  t: 

62  od\wo«clpM«ianlNU|ricU 

63  del\wof6(Mc(Hnl>l^cU'iiiiiuU\* 

64  del\wofd|Me«Mnl>ioi)icl«'^ntUV*.ieg 

65  del\word{Meitanl'copicle\iniuUS*.pic 

66  <felVword|hIe«ianI>ioj4cU'4niuU\*.cui 

67  del\wofd|M£«MDl^loi)icl•^inlUl^*.pro 

68  deI\worii{Meitonl>laiict«>iniuUV*.bat 

69  cfeI\wonl(hlettanl'«opicU'«niuUS*xxc 

70  fmdir\wordpMe«Mnt>lapicl«\infttll 


Figure  B-2.  (Continued) 
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HANDLING  PRESENTATION  DISK  SIZE  CONSTRAINTS 


The  maintenance  system  is  designed  to  distribute  courseware  on  low-density  floppy  disks.  Low- 
density  floppy  disks  can  store  a  maximum  of  360  kilobytes,  so  the  program  BLD_INS  T .  EXE  will 
not  copy  a  file  larger  than  360  kilobytes  onto  a  presentation  disk.  Because  of  this  limitation,  no 
file  larger  than  360  kilobytes  may  be  distributed.  While  it  is  somewhat  unlikely,  there  is  a  possi¬ 
bility  that  changes  to  courseware,  such  as  adding  graphic  files  or  adding  several  storyboards,  may 
cause  courseware  that  once  fit  on  a  single  floppy  disk  to  expand  beyond  the  360  l^obyte  limit. 
While  it  is  currently  impossible  to  use  the  maintenance  system  to  distribute  a  graphic  or  animation 
file  that  exceeds  360  kilobytes,  it  is  possible  to  distribute  a  lesson  segment  file  that  exceeds  360 
kilobytes. 

To  distribute  a  courseware  segment  that  exceeds  the  360-kilobyte  limit,  it  is  necessary  to  break  up 
the  segment  into  smaller  segment  files,  link  these  segment  files,  and  then  distribute  these  multiple 
linked  segments.  If  the  large  segment  is  a  “package”  of  smaller  segments,  then  the  smaller  seg¬ 
ments  can  be  used.  However,  if  the  segment  resides  in  a  bottom-level  directory,  it  will  first  be  nec¬ 
essary  to  divide  the  directory’s  courseware  into  subdirectories  and  then  to  distribute  the  new 
subdirectories’  segments. 

The  “divide  and  conquer”  strategy  for  making  large  segments  distributable  is  outlined  in  Table 
C-1.  If  the  large  segment  file  is  in  a  bottom-level  directory  of  the  courseware  directory  tree,  start 
at  step  1 .  If  the  large  segment  file  is  not  in  a  bottom-level  directory  of  the  courseware  directory  tree, 
Stan  at  step  8. 

To  get  a  practical  understanding  of  the  process  of  distributing  an  oversized  segment  file,  consider 
the  word  processing  example  (refer  to  Figure  B-1).  Suppose  that  the  DRILL  segment  was  over  360 
kilobytes.  Since  the  DRILL  directory  is  at  the  bottom  of  the  courseware  directory  tree,  you  would 
Stan  at  step  1  of  Table  C-1.  You  would  create  new  subdirectories  of  the  DRILL  directory  and 
divide  the  courseware  between  the  new  subdirectories. 

Figure  C-1  shows  that  two  new  subdirectories,  QGROUPl  and  QGROUP2 ,  have  been  added  to 
the  DRILL  directory  and  that  tlie  courseware  has  been  divided  between  the  two  new  directories. 

Figure  C-2  shows  the  contents  of  tlie  DISTRIB .  BAT  file  for  the  new  courseware  file  organiza¬ 
tion.  The  numbers  by  each  line  in  the  new  DISTRIB .  BAT  file  are  called  “line  numbers.”  As  in 
the  example  of  a  nonnal  DISTRIB ,  bat  file  given  in  Appendix  B,  line  numbers  are  used  to  isolate 
commands  in  the  new  DISTRIB .  BAT  file  and  to  describe  what  these  commands  do.  This  exam¬ 
ple,  however,  lists  only  the  line  numbers  whose  commands  pertain  to  distributing  multiple  linked 
segments. 
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Line  28  -  29  Copies  the  segment  files  from  the  QGROUPl  directory  and  the  QGROUP2  direc¬ 
tory  to  the  INSTALL  directory. 

Line  31  Sets  the  location  of  the  CATS  variable  file  for  use  by  CatSM  . 

Line  32  Uses  CATSM  to  link  the  segments  from  the  two  subdirectories. 

Table  C-1 

Making  Large  Segments  Distributable 


_ Procedure  foi  Makiiig  Large  Segments  Distributable _ _ 

1.  Break  up  the  large  •  Use  the  instructional  outline  to  help  decide  how  to  divide  the  large  course- 

segment  file.  ware  block  into  smaller  sections.  From  the  instructional  outline,  design  an 

extension  of  subdiiecUMies  under  the  current  directory  that  will  house 
these  smaller  sections. 

•  Use  the  DOS  mkdir  command  to  add  the  new  subdirectories  in  the 
directory  that  houses  the  overly  large  segment 

•  Break  up  the  courseware  for  the  overly  large  segment  If  an  individual 
storyboard  file  is  producing  an  overly  large  segment  use  your  word 
processor  to  divide  the  file  into  smaller  files,  then  place  these  smaller 
files  in  the  new  directories.  If  the  overly  large  segment  is  the  product  of 

_ several  storyboard  files,  move  these  files  into  the  new  directories. _ 


2.  BuUd  segment  flics  •  UseCATSC  to  build  the  segments  for  each  new  storyboard  file, 

for  any  new  •  Watch  for  any  compilation  errors.  If  there  are  such  errors,  reedil  the 

storyboard  files.  ^propriaie  storyboard  files  to  fix  the  error,  then  go  back  to  Jie  beginning 

_ of  step  2  to  rebtdd  the  segments  for  those  storyboard  files. _ 

3.  Test  the  new  •  Use  CATSVIEW  to  test  the  new  segment  files, 

segment  file. _ 


4.  Create  a  BUi  LD .  bat 
and  QBUILD.BAT  file 
for  each  new 
directory. 


Create  a  BUI  1>D .  BAT  for  each  new  directory.  The  easiest  way  to  create 
a  new  batch  file  is  to  alter  a  copy  of  an  existing  batch  file,  preferably  one 
that  belongs  to  a  similar  directory.  Therefore,  find  an  existing  build,  bat 
file  and  copy  it  into  the  new  directory.  (See  Appendix  A  for  more  details.) 
Edit  each  new  build  .  bat  file  with  your  word  processor  and  revise  its  DOS 
commands  to  build  segments  for  the  new  sloryb^d  files  and  to  build  the 
segment  for  the  new  directory.  Save  the  BUILD .  bat  file  as  a  nondocumeni 
orASen  file. 

Create  a  qbuild  .  bat  for  each  new  diiecloiy.  Again,  the  easiest  way  to 
create  a  new  batch  file  is  to  alter  a  copy  of  a  similar  one.  Therefore,  find  an 
existing  QBUILD .  BAT  file  and  copy  it  into  the  new  directory. 

Edit  each  new  qbuild  .  bat  file  with  your  word  processor  and  revise  its 
DOS  commands  to  build  the  package  segment  for  the  new  directory.  Save 
the  QBUILD.  BAT  file  as  a  nondocument  or  ASCII  file. 


5.  Test  all  the  new 
batch  files. 


Execute  the  new  batch  files  to  verify  that  they  are  correct  and  to  verify 
that  the  new  directory’s  package  segment  is  correct  _ 
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•  Detennine  which  batch  files  should  be  updated.  (Step  6  focuses  on  locating 
the  batch  files  that  are  affected  by  adding  a  directory  to  the  courseware 
directory  tree.  Stq>  7  covers  the  changes  liiat  should  be  made  to  these  batch 
files.)  To  loc^  die  affected  batch  files: 

a.  Move  up  one  directory.  All  batch  files  in  this  diiectmy  must  be  updated. 

b.  Move  up  one  directory.  Any  BUILD.  BAT  and  diSTRIB.bat  batch 
files  in  this  directory  mustbe  iqxlated.  Continue  this  step  until  you  reach 
the  topmost  directory  in  the  courseware  directory  tree. 

■  Steps  a  and  b  define  a  path  ofdirectoties  beginning  with  the  directory  directly 

above  the  new  directory  and  continuing  to  the  topmost  directory  in  the  CBI 
directory  tree.  All  batch  files  in  the  directory  diTOtly  above  the  new  direc- 
tcHy  must  be  updated.  In  addition,  any  build.bat  and  DISTRib.bat 
file  in  the  path  must  be  updated. _ 

•  Update  the  affected  batch  files. 

To  update  the  batch  files,  you  must  know  how  batch  files  wm’k.  Appendix  A 
describes  in  detail  how  build,  bat  and  QBUI LD . BAT  work.  Appen- 
dix  B  describes  how  DISTRIB .  BAT  works. 

Once  you  have  added  a  new  directory,  you  must  add  DOS  commands  that 
reference  the  new  directory’s  package  segment  and  any  grq)hic  or  animation 
files  in  the  new  directory. 

For  the  build  .  bat  that  is  affected  you  should: 

•  Add  commands  to  buUd  segments  for  the  new  storyboard  files. 

•  Add  a  command  to  build  a  package  segment  for  the  new  directory. 

•  Revise  the  command  that  builds  the  package  segment  for  the  directory 
directly  above  the  new  directory  to  include  the  package  segment  for  the 
new  directory. 

For  the  Qbuild.bat  that  is  affected  you  should: 

•  Revise  the  command  that  builds  the  package  segment  for  the  directory 
directly  above  the  new  directory  to  include  the  package  segment  for  the 
new  directoiy. 

For  each  Di  strib  .  BAX  that  is  affected  you  should: 

•  Add  conunands  that  copy  any  new  graphic  or  animation  files  to  the 
install  directory. 

•  Direct  the  DI  STRi  B .  BAT  file  to  distribute  courseware  using  multiple 

linked  segments.  (See  step  8.) _ 

8.  Test  all  the  •  Execute  each  updated  batch  file  to  verify  that  it  is  correct.  Executing 

updated  batch  files.  each  updated  batch  file  will  also  give  you  the  opportunity  to  verify  that  the 

package  segment  for  the  new  directory  does  not  conflict  with  the  rest  of  the 
_ courseware  in  the  directory  tree. _ 


7.  Update  the  affected 
batch  files. 


6.  Locate  any  existing 
batch  files  that  are 
unaffected. 
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9.  Modify  DiSTRiB.BAT  •  Modify  UieDiSTlB.BAT  file  for  the  courseware  that  you  wish  to  dis- 
to  distribute  tribute.  Two  basic  changes  must  be  made  to  the  distrib  .  bat 

multiple  linked  Tile: 

segments.  •  Delete  the  command  that  copies  the  segment  file  from  the  current  direc¬ 

tory  to  the  temporary  install  directory. 

•  Add  commands  to  copy  the  segment  files  from  each  of  the  current  direc¬ 
tory’s  subdirectories  into  the  temporary  install  directory. 


■  Add  a  command  to  set  the  location  of  the  CATS  variable  file  (cvars  ) 
for  use  by  CATSM. 

•  Add  a  CATSM  command  to  link  these  subdirectory  segments  within  the 
INSTALL  directory. 


Q;\WOR0P\tJP8SO«l\T0PfCW 
f.t.a  Topic;  RuanmiUtoRKSnun 


C;WOnE»>\t.6SQ<>N1ti'ro«ClAy)fllU|^ 

n.atDi« 


QUESS 


QUEST 


QUE8e.SEG 


QUES10 

■aUEB«.PiC 


QUESa 

rOUESt^fnC 


QUES10.SEQ 

QQROUP2.SEQ 

PROF1U.CAT 

qgroup2;dir 


QSUtLO.BAT 


The  DRILL  directory  has  been  split  and  its  coursevt'are  distrib¬ 
uted  into  two  new  subdirectories. 


Figure  C-1. 


C:\WORDP\LESSON1\TOPICtA\DRILL\QQROUP1  ||  C;\WOROP\LESSON1\TOPIC1AVDRILUOGROUP2 
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1  echo  off 

2  echo . 

3  echo  Build  InsuUaiion  Diiki  end  Cffieric  Student  Ditk 

4  echo  BETA  TEST  VERSION  0.25 

5  echo  14  Mar  1989 

6  echo. 

7  echo . 

8  echo  Tliii  bttch  file  will  build  iniuUatkn  diiki  tod  a  generic 

9  edio  undent  disk  for  the  TCMPICl  A  DRILL  difedory. 

10  echo. 

11  echo. 

12  echo  WARNING:  Be  fuie  that  you  have  built  up-to-date  lepaeat  file* 

13  echo  for  the  diiectoiy  before  you  um  thia  batch  file! 

14  edio. 

15  echo  Hit  [Retuni]  to  continue,  [Ctri-C]  to  atop. 

16  echo. 

17  pauae  , 

18  echo  on 


19  mkdir\wordp\letionl^topiela\dfiir\install 


20  copy^cata'4>in^egaexe\woIdpMetlonl^tapicla\lril^malall 

21  copy  \cat^bin\ninjea.bat  \wordpMeatonlVopicla>drilNnttall\go.btt 


22  oopySwordfNettonlNlopiclaVdrilhqgroupIS'.picSwordpNIeaianl^opicltVdrilNnttall 

23  capy\wordpMesionlMopicla\drilN]grouplN*.out\wor(^Mettonl'uopiclt\drilI\inttall 

24  copy\wo^dt<^leatonl'Uopicla^dril^qgroupl\*.pto\woldp^letlool^aopicla''<^ril^anttall 


25  copy  \word[^leaaonI^topicla^drilhqgraup2^*.p■c  VwordpVeatonlNicpicUVdrilNnatall 

26  oapyVword{h!eaacn]Vlop!cla'^iilN]gr<Mp2v*.cut\wordpVesion!\icpicla\drilI\inatsll 

27  copy  VwoidFNeatonl'Uopicla\drilhqgfOup2y»  .pro  \wordp\le>aonlVtopicla>riri]Nnatall 

28  copyXwoTdpdetaanlNopiclaNdrilNigrouplVigroupl.iegNwon^MeaianlUopicUVdrilNnatall 

29  copy  \wonltNe»ionl\lopiclaVdrilhqgroup2vigroup2.teg  VvordpVeaionl^opiclaVJrilNnttall 

30  cd\wordp''leaaonlVopiclaNdrilNniull 


31  act  catavara^wordpNcvart 


32  catim  qgroupl.aeg  qgroup2iee  >\wofdp'^letaonl\topicla'<lrilN)ld-erTt 


33  echo  off 

34  echo. 

35  echo . 

36  echo  Building  a  generic  atudenl  disk  for  the  TOPICIA  CBI. 

37  echo . 

38  echo . 

39  echo . 

40  echo  Please  place  the  generic  auidsnt  disk  in  drive  A: 

41  echo. 

42  pause 

43  echo  on 


44  echo .  >  ret 

45  echo  n  » let 

46  foniiat  a:  <  ret 


47  copy  profile.cat  a: 

48  copy  profile.cat  a:profile.fu 

49  del  profile.cat 

Figure C>2.  Listing  of  the  OISTRIB.BAT  file  to  distribute 
courseware  using  multiple  linked  segments. 
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50  echoolf 

51  echo. 

52  echo . 

53  echo. 

54  echo  Builduig  iniiilhtioti  diiki  foe  ihc  TOTICl A  DRILL  CBi 

55  echo. 

56  echo. 

57  echo. 

58  echooa 

59  Mdl Jnet-we  »: 

60  odViraid{Mes«anl\(oficleVdnll 

61  6elVwoni{NeffanI>(0|)icleNdrilNiitulN* 

62  delNwoni|NefMnl\i<)i)icliNdrilNMUUV*.*e( 

63  dd\wold{Mellanl^lopKl•^dril^tluul^*.pic 

64  del\wo^l^Me«ionl^opieU^dfil^«luUl^*.ctR 

65  del\woniiMefK)nl\iopicla>drilNiifUlI\*.pro 

66  de]\wofd{MeiianlNtopicla>dfilhiniUUv.*.tMt 

67  delVwon^es<anlViapicla>drilNnauOv*.exe 

68  nndirVonlpMeaKinl'^opicla'^JriHNiniull 

69  more  <  bld-em 


Figure  C>2  (Continued) 
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